This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Mention Termux in README.android
authorRichard Leach <rich+perl@hyphen-dash-hyphen.info>
Mon, 20 May 2019 01:37:04 +0000 (01:37 +0000)
committerKarl Williamson <khw@cpan.org>
Wed, 30 Oct 2019 13:53:06 +0000 (07:53 -0600)
README.android

index defcd95..c9be849 100644 (file)
@@ -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>