1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
|
Build instructions for the Android port
---------------------------------------
If you are looking for instructions on how to use the Android port, what the
preferences mean etc. you should check out instead:
http://pocketatari.atari.org/android
See also DOC/README.android.
I. Prerequisites
----------------
To compile the Android port, you are going to need:
1. A working autotools/make environment (e.g. Cygwin or MinGW on Windows).
Before trying to build the Android port, it is a good idea to first try building
the desktop version, for instance the SDL port. It is a good way to verify that
the necessary tools are installed and working correctly. See DOC/INSTALL to
build Atari800 on Unix environments, or DOC/BUILD.windows to build under Cygwin
and MinGW.
2. The Java JDK.
The latest Java 8 release at the time of this writing, ie. 8u271, is known to
work correctly:
https://www.oracle.com/java/technologies/javase/javase-jdk8-downloads.html
Java versions newer than 8 will not work.
Note for Linux users: the OpenJDK 8 package, as available in e.g.
Ubuntu under the name "openjdk-8-jdk", is a good choice.
3. Apache Ant:
https://ant.apache.org/bindownload.cgi
4. The Android SDK.
Atari800 requires tools that have since been removed from the newest version of
the Android SDK (specifically, "android update project" is no longer available).
Until Atari800 gets updated, you will have to use an older version, which
unfortunately is no longer downloadable from the Android Developers' website.
The necessary parts of the SDK, though, can be obtained through direct download
links. Here's how to get them:
a) Get Android SDK Tools not newer that v. 25.2.5, through a direct
download link. As of May 2018 the functioning links are in the form of:
http://dl-ssl.google.com/android/repository/tools_r25.2.5-<host>.zip
where <host> shall be replaced with one of:
* windows - for Windows 32/64-bit
* macosx - for MacOS X
* linux - for Linux 64-bit
b) Create a directory for the SDK, e.g. /path/to/android-sdk. Unzip the
downloaded SDK there - it should create a subdirectory named tools/.
c) Set the JAVA_HOME environment variable to point to the root directory of your
JDK installation, e.g.:
# export JAVA_HOME='C:\Java\jdk1.8.0_172'
d) Navigate to the SDK's tools/bin/ directory, e.g.:
# cd /path/to/android-sdk/tools/bin
e) Run sdkmanager to install SDK Platform Tools, SDK Build Tools and platform
version 20:
# ./sdkmanager "platform-tools" "build-tools;27.0.3" "platforms;android-20"
Note: On Windows the tool is called sdkmanager.bat isntead of sdkmanager.
5. The Android NDK
Again, Atari800 has not been adapted to the latest changes in the NDK, so you
need to use a version not later than r15c. Get it from:
https://developer.android.com/ndk/downloads/older_releases
and unzip the archive to a directory, e.g. /path/to/android-ndk-r15c.
6. Assorted libraries
The old Android NDK might require some old libraries that are no longer
installed by default on modern Linux distributions. For example, it requires:
libncurses5
II. Setting up the environment
------------------------------
1. Set the ANDROID_NDK_ROOT environment variable to point to the root directory
of the NDK that you unzipped earlier, e.g.:
# export ANDROID_NDK_ROOT='/path/to/android-ndk-r15c'
Note for Windows: Since the Windows NDK is built without Cygwin awareness, the
path in ANDROID_NDK_ROOT should be set using windows notation, e.g.:
# export ANDROID_NDK_ROOT='C:\path\to\android-ndk-r15c'
Also, make sure the NDK is accessible by normal Windows methods (i.e. no
symlinks in Cygwin).
2. Set the JAVA_HOME environment variable to point to the root directory of your
JDK installation, e.g.:
# export JAVA_HOME='C:\Java\jdk1.8.0_172'
3. Make sure that ant is accessible in PATH. If not, add it:
# export PATH="/path/to/apache-ant-1.10.9/bin:$PATH"
4. Add the NDK root, gcc and android tools paths to PATH, e.g.:
# export PATH="/path/to/android-ndk-r15c:/path/to/android-ndk-r15c/toolchains/arm-linux-androideabi-4.9/prebuilt/<build-os>/bin:/path/to/android-sdk/tools:/path/to/android-sdk/platform-tools:$PATH"
(Replace <build-os> above with the directory that matches your build environment, e.g. linux-x86_64, windows-x86_64, ...)
III. Compiling
--------------
1. Unpack the source tarball of Atari800.
2. Go to the atari800 directory and update the Android project files:
# android update project --path src/android --name colleen --target "android-20"
Note: On Windows the tool is called android.bat isntead of android.
2. If the configure scrips is missing, create it:
# ./autogen.sh
3. Configure the build. Generally you should enable exactly the features listed
below:
# ./configure --target=android --disable-monitorbreak --enable-pagedattrib --enable-seriosound --disable-crashmenu --disable-monitorasm --disable-monitorhints --without-readline --enable-clipsound --disable-riodevice
Enabling or disabling other reatures is not guaranteed to build correctly.
4. Build the APK package:
# make
After a while, the APK package should appear in:
src/android/bin/colleen-debug.apk
Cheers,
Kostas
|
