summaryrefslogtreecommitdiff
path: root/README.android
diff options
context:
space:
mode:
authorRichard Leach <rich+perl@hyphen-dash-hyphen.info>2019-05-20 01:37:04 +0000
committerKarl Williamson <khw@cpan.org>2019-10-30 07:53:06 -0600
commit908c3276238e1a7618572c08b4106f2e9f1c051c (patch)
tree3d9760807fc35fe7921c67fe37db0d53b535b91d /README.android
parent17d445953201af33b64e278caa974aeae05a2c95 (diff)
downloadperl-908c3276238e1a7618572c08b4106f2e9f1c051c.tar.gz
Mention Termux in README.android
Diffstat (limited to 'README.android')
-rw-r--r--README.android26
1 files changed, 20 insertions, 6 deletions
diff --git a/README.android b/README.android
index defcd95999..c9be849cb3 100644
--- a/README.android
+++ b/README.android
@@ -8,9 +8,9 @@ perlandroid - Perl under Android
=head1 SYNOPSIS
-The first portions of this documents contains instructions
+The first portions of this document contains instructions
to cross-compile Perl for Android 2.0 and later, using the
-binaries provided by Google. The latter portion describes how to build
+binaries provided by Google. The latter portions describe how to build
perl native using one of the toolchains available on the Play Store.
=head1 DESCRIPTION
@@ -181,10 +181,13 @@ itself off once, and then back on again.
=head1 Native Builds
While Google doesn't provide a native toolchain for Android,
-you can still get one from the Play Store; for example, there's the CCTools
-app which you can get for free.
-Keep in mind that you want a full
-toolchain; some apps tend to default to installing only a barebones
+you can still get one from the Play Store.
+
+=head2 CCTools
+
+You may be able to get the CCTools app, which is free.
+Keep in mind that you want a full toolchain;
+some apps tend to default to installing only a barebones
version without some important utilities, like ar or nm.
Once you have the toolchain set up properly, the only
@@ -197,6 +200,17 @@ compiling perl is little more than:
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"
+=head2 Termux
+
+L<Termux|https://termux.com/> provides an Android terminal emulator and Linux environment.
+It comes with a cross-compiled perl already installed.
+
+Natively compiling perl 5.30 or later should be as straightforward as:
+
+ sh Configure -des -Alibpth="/system/lib /vendor/lib"
+
+This certainly works on Android 8.1 (Oreo) at least...
+
=head1 AUTHOR
Brian Fraser <fraserbn@gmail.com>