forked from KolibriOS/kolibrios
112 lines
3.7 KiB
Plaintext
112 lines
3.7 KiB
Plaintext
To build/debug android build.
|
|
|
|
1) Download the android sdk, and install it. On windows I unpacked it as:
|
|
|
|
C:\Program Files\android-sdk-windows
|
|
|
|
on Macos as:
|
|
|
|
/Library/android-sdk-mac_x86
|
|
|
|
On windows add: C:/Progra~1/android-sdk-windows/tools to your path.
|
|
On linux/macos add the equivalent.
|
|
|
|
2) Download the android ndk, and install in. On windows I unpacked it as:
|
|
|
|
C:\Program Files\android-ndk-r5
|
|
|
|
on Macos as:
|
|
|
|
/Library/android-ndk-r5
|
|
|
|
On windows add: C:/Progra~1/android-ndk-r5 to your path. On linux/macos
|
|
add the equivalent.
|
|
|
|
3) On windows, to use the ndk, you *must* be running under cygwin. This means
|
|
you need to install Cygwin 1.7 or greater now.
|
|
|
|
In the current release of the ndk (r5), when running under cygwin, there are
|
|
bugs to do with the automatic conversion of dependencies from DOS format
|
|
paths to cygwin format paths. The 2 fixes can be found in:
|
|
|
|
<http://groups.google.com/group/android-ndk/msg/b385e47e1484c2d4>
|
|
|
|
4) Bring up a shell, and run 'android'. This will bring up a graphical
|
|
gui for the sdk. From here you can install the different SDK components
|
|
for the different flavours of android. Download them all - bandwidth and disk
|
|
space are cheap, right?
|
|
|
|
5) Now go to the Virtual Devices entry on the right hand side. You need to
|
|
create yourself an emulator image to use. Click 'New...' on the right hand
|
|
side and a window will appear. Fill in the entries as follows:
|
|
|
|
Name: FroyoEm
|
|
Target: Android 2.2 - API Level 8
|
|
SD card: Size: 1024MiB
|
|
Skin: Resolution: 480x756 (756 just fits my macbook screen, but 800 may
|
|
be 'more standard')
|
|
|
|
Click 'Create AVD' and wait for a minute or so while it is prepared. Now
|
|
you can exit the GUI.
|
|
|
|
6) Now we are ready to build mupdf for Android. Check out a copy of MuPDF
|
|
(but you've done that already, cos you're reading this, right?).
|
|
|
|
7) You will also need a copy of mupdf-thirdparty.zip (see the source code
|
|
link on http://mupdf.com/). Unpack the contents of this into a 'thirdparty'
|
|
directory created within the mupdf directory (i.e. at the same level as
|
|
fitz, pdf, android etc).
|
|
|
|
8) Finally, you will need a copy of a 'generated' directory. This is not
|
|
currently available to download. The easiest way to obtain this is to do
|
|
a standard windows or linux build of mupdf, which generates the required
|
|
files as part of the build process.
|
|
|
|
9) Change into the android directory, and edit local.properties into your
|
|
favourite editor. Change the sdk path there as appropriate. This should be
|
|
the only bit of localisation you need to do.
|
|
|
|
10) Change into the android directory (note, the android directory, NOT
|
|
the android/jni directory!), and execute (in a Cygwin window on Windows!):
|
|
|
|
ndk-build
|
|
|
|
This should build the native code portion. Then execute:
|
|
|
|
ant debug
|
|
|
|
or on windows under cygwin:
|
|
|
|
ant.bat debug
|
|
|
|
This should build the java wrapper.
|
|
|
|
11) Now start the emulator by executing:
|
|
|
|
emulator -avd FroyoEm
|
|
|
|
This will take a while to full start up (be patient).
|
|
|
|
12) We now need to give the demo file something to chew on, so let's copy
|
|
a file into the SD card image of the emulator (this should only need to be
|
|
done once). With the emulator running type:
|
|
|
|
adb push ../../MyTests/pdf_reference17.pdf /mnt/sdcard/Download/test.pdf
|
|
|
|
(where obviously ../../MyTests/pdf_reference17.pdf is altered for your
|
|
machine). (adb lives in <sdk>/platform-tools if it's not on your path).
|
|
|
|
13) With the emulator running (see step 11), execute
|
|
|
|
ant install
|
|
|
|
('ant.bat install' on Windows) and that will copy MuPDF into the emulator
|
|
where you can run it from the launchpad screen.
|
|
|
|
14) To see debug messages from the emulator (including stdout/stderr from
|
|
our app), execute:
|
|
|
|
adb logcat
|
|
|
|
Good luck!
|