mirror of https://github.com/aria2/aria2
Added README and release helper script for Android build
Tatsuhiro Tsujikawa
parent
5d3b6801b1
commit
fc0e378e29
|
|
@ -0,0 +1,75 @@
|
||||||
|
aria2 for Android devices
|
||||||
|
=========================
|
||||||
|
|
||||||
|
aria2 is a lightweight multi-protocol & multi-source download utility
|
||||||
|
operated in command-line. It supports HTTP/HTTPS, FTP, BitTorrent and
|
||||||
|
Metalink.
|
||||||
|
|
||||||
|
Install
|
||||||
|
-------
|
||||||
|
|
||||||
|
aria2 is not an ordinary Android Java application. It is a C++ native
|
||||||
|
application and operates in command-line. You don't have to 'root'
|
||||||
|
your device to use aria2. Because aria2 is a command-line program,
|
||||||
|
you need a terminal emulator. First install Android Terminal Emulator
|
||||||
|
from Android Market (or build it from source and install. See
|
||||||
|
https://github.com/jackpal/Android-Terminal-Emulator/).
|
||||||
|
|
||||||
|
1. Copy aria2c executable to ``/mnt/sdcard`` on your device.
|
||||||
|
2. Run Android Terminal Emulator.
|
||||||
|
3. ``mkdir /data/data/jackpal.androidterm/aria2``
|
||||||
|
4. ``cat /mnt/sdcard/aria2c > /data/data/jackpal.androidterm/aria2/aria2c``
|
||||||
|
5. ``chmod 744 /data/data/jackpal.androidterm/aria2/aria2c``
|
||||||
|
6. Add the following commands to the initial command of Android
|
||||||
|
Terminal Emulator::
|
||||||
|
|
||||||
|
export HOME=/data/data/jackpal.androidterm/aria2; cd $HOME
|
||||||
|
|
||||||
|
7. Exit Android Terminal Emulator.
|
||||||
|
8. Run Android Terminal Emulator again.
|
||||||
|
9. See whether aria2c actually works by invoking ``./aria2c -v``
|
||||||
|
|
||||||
|
How to use
|
||||||
|
----------
|
||||||
|
|
||||||
|
See `the online manual
|
||||||
|
<http://aria2.sourceforge.net/manual/en/html/>`_.
|
||||||
|
|
||||||
|
Notes
|
||||||
|
-----
|
||||||
|
|
||||||
|
aria2c executable was generated using android-ndk-r8.
|
||||||
|
|
||||||
|
The following libraries were statically linked.
|
||||||
|
|
||||||
|
* openssl 1.0.1c
|
||||||
|
* expat 2.1.0
|
||||||
|
* c-ares 1.9.1
|
||||||
|
|
||||||
|
Since Android does not have ``/etc/resolv.conf``, c-ares (asynchronous
|
||||||
|
DNS resolver) is disabled by default. But name resolution is sometimes
|
||||||
|
a little bit slow, so I recommend to enable c-ares. You can enable it
|
||||||
|
using ``--async-dns`` and specify DNS servers using
|
||||||
|
``--async-dns-server`` option, like this::
|
||||||
|
|
||||||
|
--async-dns --async-dns-server=`getprop net.dns1`,`getprop net.dns2`
|
||||||
|
|
||||||
|
Because it is tedious to type these long parameters every time you use
|
||||||
|
aria2c, the following wrapper shell script would be handy::
|
||||||
|
|
||||||
|
#!/system/bin/sh
|
||||||
|
/data/data/jackpal.androidterm/aria2c \
|
||||||
|
--async-dns \
|
||||||
|
--async-dns-server=`getprop net.dns1`,`getprop net.dns2` \
|
||||||
|
"$@"
|
||||||
|
|
||||||
|
Please note that you need to add executable file mode bit to this
|
||||||
|
wrapper script too. (e.g., ``chmod 744 /PATH/TO/SCRIPT``)
|
||||||
|
|
||||||
|
Known Issues
|
||||||
|
------------
|
||||||
|
|
||||||
|
* Since Android does not have ``/dev/stdout``, ``-l-`` does not work.
|
||||||
|
|
||||||
|
* Android Terminal Emulator sometimes stops updating console. It looks
|
||||||
|
like aria2c hangs, but aria2c continues to run.
|
||||||
|
|
@ -0,0 +1,58 @@
|
||||||
|
#!/bin/sh -e
|
||||||
|
|
||||||
|
# aria2 - The high speed download utility
|
||||||
|
#
|
||||||
|
# Copyright (C) 2012 Tatsuhiro Tsujikawa
|
||||||
|
#
|
||||||
|
# This program is free software; you can redistribute it and/or modify
|
||||||
|
# it under the terms of the GNU General Public License as published by
|
||||||
|
# the Free Software Foundation; either version 2 of the License, or
|
||||||
|
# (at your option) any later version.
|
||||||
|
#
|
||||||
|
# This program is distributed in the hope that it will be useful,
|
||||||
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||||
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||||
|
# GNU General Public License for more details.
|
||||||
|
#
|
||||||
|
# You should have received a copy of the GNU General Public License
|
||||||
|
# along with this program; if not, write to the Free Software
|
||||||
|
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
|
||||||
|
#
|
||||||
|
# In addition, as a special exception, the copyright holders give
|
||||||
|
# permission to link the code of portions of this program with the
|
||||||
|
# OpenSSL library under certain conditions as described in each
|
||||||
|
# individual source file, and distribute linked combinations
|
||||||
|
# including the two.
|
||||||
|
# You must obey the GNU General Public License in all respects
|
||||||
|
# for all of the code used other than OpenSSL. If you modify
|
||||||
|
# file(s) with this exception, you may extend this exception to your
|
||||||
|
# version of the file(s), but you are not obligated to do so. If you
|
||||||
|
# do not wish to do so, delete this exception statement from your
|
||||||
|
# version. If you delete this exception statement from all source
|
||||||
|
# files in the program, then also delete it here.
|
||||||
|
|
||||||
|
if [ -z "$ANDROID_HOME" ]; then
|
||||||
|
echo 'No $ANDROID_HOME specified.'
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
TOOLCHAIN=$ANDROID_HOME/toolchain
|
||||||
|
PATH=$TOOLCHAIN/bin:$PATH
|
||||||
|
|
||||||
|
VERSION=$1
|
||||||
|
ANDROID_API=$2
|
||||||
|
if [ -z "$VERSION" ]; then
|
||||||
|
echo "No version specified"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
if [ -z "$ANDROID_API" ]; then
|
||||||
|
echo "No android API specified"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
DIST_DIR=aria2-$VERSION-$ANDROID_API-build1
|
||||||
|
arm-linux-androideabi-strip src/aria2c
|
||||||
|
mkdir $DIST_DIR
|
||||||
|
cp AUTHORS COPYING ChangeLog LICENSE.OpenSSL NEWS README.html README.android \
|
||||||
|
src/aria2c $DIST_DIR
|
||||||
|
zip -9 -r $DIST_DIR.zip $DIST_DIR
|
||||||
|
rm -rf $DIST_DIR
|
||||||
Loading…
Reference in New Issue