This document describes how to set up your host environment when
attempting to build Perl for Android.
-=head1 Cross-Compiling Perl
+=head1 Cross-compilation
These instructions assume an Unixish build environment on your host system;
they've been tested on Linux and OS X, and may work on Cygwin and MSYS.
or if you don't feel like installing an sshd app on your device,
you may want to use adb, although you may be forced to switch to ssh if
your device is not rooted and you're unlucky -- more on that later.
-Alternatively, if you're cross-compiling for an emulator, you'll have to
+Alternatively, if you're cross-compiling to an emulator, you'll have to
use adb.
=head3 adb
To use ssh, you'll need to install and run a sshd app and set it up
properly. There are several paid and free apps that do this rather
-easily, so you should be able to spot one easily.
+easily, so you should be able to spot one on the store.
Remember that Perl requires a passwordless connection, so set up a
public key.
particularly t/re/uniprops, may crash the phone, causing it to turn
itself off once, and then back on again.
+=back
+
=head1 Native Builds
While Google doesn't provide a native toolchain for Android,
/data/data/com.pdaxrom.cctools/root/cctools. With the path in hand,
compiling perl is little more than:
- export SYSROOT=<location of the native toolchain>
- export LD_LIBRARY_PATH="$SYSROOT/lib:`pwd`:`pwd`/lib:`pwd`/lib/auto:$LD_LIBRARY_PATH"
- sh Configure -des -Dsysroot=$SYSROOT -Alibpth="/system/lib /vendor/lib"
-
-=back
+ export SYSROOT=<location of the native toolchain>
+ export LD_LIBRARY_PATH="$SYSROOT/lib:`pwd`:`pwd`/lib:`pwd`/lib/auto:$LD_LIBRARY_PATH"
+ sh Configure -des -Dsysroot=$SYSROOT -Alibpth="/system/lib /vendor/lib"
=head1 AUTHOR