Custom Drawn Interface/Android/ja

From Free Pascal wiki
Revision as of 21:33, 8 January 2021 by Giorgio Tani (talk | contribs) (→‎Use the ready Virtual Box Image with FPC and Lazarus: updated link to up to date PeaZip project address)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigationJump to search

English (en) español (es) 日本語 (ja) русский (ru)

メインページ - Lazarus Documentation日本語版 - 翻訳ノート - 日本語障害情報

Go back to Custom Drawn Interface

※今のところ、Windows上でAndroidプログラミングを実際にできるようにすることを優先目標として記述しています。そのため、原文の翻訳となっていないところが多いです。間違い等はどんどん修正していただけると幸いです。(2014-01-26 by malcome)


LCL-CustomDrawn-Android utilizes a minimal Java application which communicates with our Pascal library and sends all events to it and also obeys commands from it. The communication is done via JNI as supported by Google. The controls are not native, instead they are all drawing using TRawImage+TLazIntfImage+TLazCanvas and events and the painting are clipped using LazRegions. The drawing itself is done in Pascal using jnigraphics to draw on a Bitmap Java object which is then drawn by the minimal Java activity on a SurfaceView.

Our previous and short-lived attempt to write an LCL Interface for Android (LCL-Android) utilized a non-standard method of using native executables which communicated with a Java machine via Pipes. This method was abandoned because it was considered unsupported by Google. It is considered obsolete and people should use LCL-CustomDrawn-Android instead. This older interface was documented in Android Interface.


Part 1, until March 2012:

  1. Build the set of Lazarus Custom Drawn Controls
  2. Initial bindings for the Android APIs
  3. Create an application to automatically generate the bindings
  4. Start the new widgetset
  5. Implement support for JNI
  6. Merge the Lazarus Custom Drawn Controls into the LCL and use them to implement all basic controls
  7. Add text support for Android
  8. Implement basic window client area scrolling
  9. Add mobile emulator for desktop platforms
  10. Improve the mobile scrolling
  11. Add text support in X11
  12. Add DPI awareness and adaptation in the LCL
  13. Add non-native text support via pasfreetype

Part 2: April, May, June 2012:

  1. TButton improve the Android visual
  2. TBitBtn
  3. TRadioButton finish the native look
  4. Calendar dialog -> Problematic as the LCL has no calendar dialog, it just opens a normal form and puts a calendar on it, so we need a TCDCalendar widget
  5. MaskEdit
  6. Improve TComboBox
  7. TMemo
  8. TListView as a list with columns
  9. TMainMenu
  10. Database with sqlite
  11. Barcode reading
  12. Windows add-on installer

Using the Android SDK, Emulator and Phones

Custom Drawn Interface/Using the Android SDK, Emulator and Phones

Android Programming

See Android Programming, also includes caracteristics of the various phones relevant for programming.

Configuring the Free Pascal Compiler for Android

Use the ready Virtual Box Image with FPC and Lazarus

The fastest way to configure Free Pascal and Lazarus for Android development is simply using a pre-configured virtual machine image which already includes Mageia Linux 1, KDE, Lazarus 0.9.31, Subversion, Free Pascal for both x86-linux and arm-linux (targetting Android), the Android SDK, the Android NDK, Java, Ant, Gtk2 and all it's development packages, the GNU debugger (GDB), subversion and everything else necessary for building Android applications with Lazarus.

The download like for the virtual machine image is: (warning: the VirtualBox image was created using the Mac OS X default Zip utility and not all zip applications can handle it. The Mac OS X default zip application can, and PeaZip too and WinRAR too. Both 7-Zip and the Windows 7 default unzipper fail.

The virtual machine image is composed by two files: “Android Devel VM.vbox” and “Android Devel VM.hdd”. Both need to be located in the same folder and also note that the source forge download is a zipped file, so it needs to be unzipped. After unzipping the VM image has 5,2GB. To use this virtual machine one should install Virtual Box and then use it to open the .vbox file. Then one can already use this Linux virtual machine to build Android applications. The process of building an application involves first opening Lazarus and building the application in Lazarus, for example the example project available on ~/Programas/lazarus/example/androidlcl/ and then going into the Linux terminal, navigating to ~/Programas/lazarus/example/androidlcl/android and issuing the command “ant debug” which will generate the APK file in ~/Programas/ lazarus/example/androidlcl/android/bin/LCLExample-debug.apk. There are two users in the virtual machine: “root” and “pascaldev” and both of them use the password “root”.

Note that the virtual machine contains the Lazarus source code from when it was created, but one can also use svn update to get the latest code. Note that this involves some risks, however, as the trunk version might ocasionally contain problems.

Windows 上で Lazarus を用いて Android アプリを開発するための準備

Step 1 - Android SDK の準備 から Windows 用 Android SDK の zip ファイルをダウンロードし、適当なフォルダ(以下ではc:\work\android\sdkと仮定)に解凍します。
2015-12-07追記: 上記ウェブサイトの、「Other Download Options」「SDK Tools Only」セクションにある、 で動作することを確認しました。

Step 2 - Android NDK の準備 から Windows 用 Android NDK をダウンロードし、適当なフォルダ(以下ではc:\work\android\ndkと仮定)に解凍します。
2015-12-07追記: android-ndk-r10e-windows-x86.exe にて動作確認しました。

Step 3 - Android JDK の準備

作成予定のプログラムで JAVAのライブラリを使用しない場合でも、apk ファイルの作成のために JDK に含まれるツールを使用します。したがって、JDK をインストールする必要があります。 から Windows 用 JDK の exe ファイルをダウンロードしてインストールしてください。(以下ではC:\Program Files\Java\jdk1.7.0_51 にインストールしたと仮定します)
2014-01-25 動作確認: jdk-7u51-windows-i586.exe

Step 4 - Apatch Ant の準備

原文では Windows で Apatch Ant を使用せずに apk ファイルを作成できることを紹介していますが、Apatch Ant を使用した方が楽ですしネット上の情報も多いです。 から Apache Ant をダウンロードし(2015-12-03追記:apache-ant-1.9.6-bin.zipで動作確認しました)、適当なフォルダ(以下ではc:\work\tools\antと仮定)に展開してください。
Apatch Ant による apk ファイルの作成方法:
アプリケーション固有の build.xml があるフォルダ内に次のような buildapk.bat を作成して、コマンドプロンプトから「buildapk debug」などとしてバッチを実行することで apk ファイルが作成できます。

REM Adjust the path to yours path
set ANT_HOME=C:\work\tools\ant
set JAVA_HOME=C:\Program Files\Java\jdk1.7.0_51

set Path=%JAVA_HOME%\bin

%ANT_HOME%\bin\ant %1 %2 %3 %4 %5 %6 %7 %8 %9

Step 5 - Lazarus の準備

通常は最新の安定版をダウンロードしてインストールすれば十分です。(以下では、c:\lazarus にインストールされたものと仮定する)

Step 6 - FPC 3.0.0 の準備 から、 をダウンロードして適当なフォルダ(以下では c:\work\fpcsrc と仮定)に展開します。
次に、c:\work\fpcsrc\buildfpc.bat を次の内容で作成します。
各PATH は環境に合わせて設定しなおしてください。なお、ここでは ARMv6 を最低現の対象機種としています。 また、FPCのバージョン部分は適切に修正してください。下記ではLazarus 1.4.4 に付属しているFPC2.6.4を使用してFPC3.0.0をビルドしています。 なお、Lazarus にすでに FPC 3.0.0 をインストール済みの場合は、クロスコンパイラだけビルドすればよいので、バッチ内の「Build FPC」、「Create fpc.cfg」という部分は不要です。

REM Adjust the path to yours path
SET LAZ_PATH=C:\lazarus
SET NDK_PATH=C:\work\android\ndk\toolchains\arm-linux-androideabi-4.8\prebuilt\windows\bin

Set Path=%NDK_PATH%;%LAZ_PATH%\fpc\2.6.4\bin\i386-win32

REM =============== Build FPC
make all
make install INSTALL_PREFIX=%LAZ_PATH%\fpc\3.0.0

REM =============== Build cross compiler
make clean crossall crossinstall OS_TARGET=android CPU_TARGET=arm CROSSOPT="-OoFASTMATH -CpARMV6" INSTALL_PREFIX=%LAZ_PATH%\fpc\3.0.0

REM =============== Create fpc.cfg
%LAZ_PATH%\fpc\3.0.0\bin\i386-win32\fpcmkcfg.exe -d basepath=%LAZ_PATH%\fpc\3.0.0 -o %LAZ_PATH%\fpc\3.0.0\bin\i386-win32\fpc.cfg


cd c:\work\fpcsrc

これで FPC の準備ができました。

Step 7 - cross-binutils のコピー

C:\work\Android\ndk\toolchains\arm-linux-androideabi-4.8\prebuilt\windows\bin フォルダ内のすべてのファイル(おそらくすべて arm-linux-androideabi-*.exe という名前)を、C:\lazarus\fpc\3.0.0\bin\i386-win32 フォルダにコピーします。

Step 8 - Lazarus の設定

Lazarus を起動し、Tools->Options の、Environment->Files の、Compiler executable の 2.6.4 という部分を 3.0.0 に変更します。
例) 「C:\lazarus\fpc\2.6.4\bin\i386-win32\fpc.exe」を、「C:\lazarus\fpc\3.0.0\bin\i386-win32\fpc.exe」に変更。

・・・この後は、新規プロジェクトでLinuxライブラリ(.so)を作成し各種設定をしますが、Android プログラミングの知識がやや必要になります。・・・

Project->Project Options の、Compiler Options->Paths の、Libraries に
を追加する。(andoroid-9 の数字の部分は minimum API レベルにより変わる)

Project->Project Options の、Compiler Options->Other の、Custom options に

Project->Project Options の、Compiler Options->Config and Target の、 Target OS を Android に、Taget CPU を arm に、Target processor を ARMV6などに設定する。

さらに、Android SDK に付属する SDK Manager.exe を用いて、使用するAPI(例:Android 2.3.3(API10))を導入するなどの作業も必要です。

・・・ここまですれば Android_Programming で紹介されている NDK_OpenGL_example はコンパイルできましたし、完成した apk を実機にインストールして見事に動作させることができました。しかし、今のところ、下記の androidlcltest.lpi は、「・・・fpc\2.7.1\bin\i386-win32\arm-linux-androideabi-ld.bfd.exe: BFD (GNU Binutils) 2.23.2 assertion fail /s/ndk-toolchain/src/build/../binutils/binutils-2.23/bfd/elf32-arm.c:12336」というエラーが出てコンパイルできませんでした。個人的には NDK で OpenGL が使えれば十分なので、Custom Drawn についての調査は時間がかかるかもしれません。識者の情報をお待ちします。

Now you can already build the example project androidlcltest.lpi using the Windows-Release build mode

Building the compiler yourself in Linux

See Setup_Cross_Compile_For_ARM and make sure to use the option OPT="-dFPC_ARMEL" for building the compiler.

Using the pre-compiled compiler in Linux

A pre-compiled compiler is provided for convenience for users. The following steps were tested in Mandriva Linux 2010.0 and 2010.1:

Required Environment

  • The latest stable FPC installed in the system via the RPM / DEB / TAR package

Step 1 - Install the cross-binutils

For Mandriva Linux the RPM package containing arm-linux-as, arm-linux-ld, etc, which are the cross-binutils can be found here:

Just download the RPM package and install it using:

rpm -ivh cross-arm-binutils- 

In Mandriva Linux 2010.0 the dependencies won't match, as the package is for 2010.1, but one can simply ignore this problem and it works fine using --nodeps:

rpm -ivh --nodeps cross-arm-binutils- 

For other distributions use the corresponding package, or else read the instructions for building the cross-binutils yourself at Setup_Cross_Compile_For_ARM

Step 2 - Configure the cross-binutils

The assembler needs a parameter to tell it which ARM ABI to use. A choice which works good is EABI-5, which is compatible with all Android devices available as of Jan 2011. To set this, we will rename the original assembler and substitute it with a shell script which passes the desired parameter. These commands will do it:

mv /usr/bin/arm-linux-as /usr/bin/arm-linux-as_org
gedit /usr/bin/arm-linux-as

Now paste into the editor this code:

/usr/bin/arm-linux-as_org -meabi=5 $@

And don't forget to then make it executable:

chmod 755 /usr/bin/arm-linux-as

Step 3 - Install the Free Pascal Cross-Compiler

At this point the pre-compiled FPC can be download from here:

Then use these commands to install the pre-compiled Free Pascal cross-compiler into /usr:

[felipe@localhost Programas]$ ls -l
total 20664
-rw-rw-r--  1 felipe felipe 17098552 2010-10-25 08:17 fpc-2.5.1.arm-linux.tar.gz
[felipe@localhost Programas]$ su
[root@localhost Programas]# cp fpc-2.5.1.arm-linux.tar.gz /usr/
[root@localhost Programas]# cd /usr/
[root@localhost usr]# tar -xvf fpc-2.5.1.arm-linux.tar.gz 
[root@localhost usr]# ln -s /usr/lib/fpc/2.5.1/ppcrossarm /usr/bin/ppcrossarm

Step 4 - Verify if your Cross-Compiler works

If you made no errors in the previous steps, it should work, so try to call it like this:

[felipe@localhost Programas]$ /usr/bin/ppcrossarm

If this command works and fpc shows its options, then you configured the cross-compiler correctly, if not, then try to find out if your symbolic link points to a correct location with this command:

[felipe@localhost Programas]$ ls -ls /usr/bin/ppc*

Now we are ready to compile Android applications using the Lazarus IDE! Configuring the fpc.cfg file isn't necessary, the old compiler will automatically find the new compiler and it's object files.

Compiling the example LCL Android Application

Step 1 - Download the source code

The source code of the example is located inside the Lazarus sources in lazarus/examples/androidlcl/androidlcltest.lpi

Step 2 - Make sure you have the Java JDK and the Android SDK and NDK installed

Read here: Custom_Drawn_Interface/Android#Install_the_Java_JDK_and_the_Android_SDK_and_NDK

Step 3 - Build the project using the Lazarus IDE

Configuring Lazarus itself to use the new compiler should not normally be necessary because fpc should be able to find the symlink created, but if you have trouble in this part you can try to hard code the compiler path to use the new crosscompiler. To hardcode the compiler path in cause of trouble go to the menu "Tools->Options" and change the "Compiler Path" to "/usr/bin/ppcrossarm"

But it is necessary to configure the LPI file to build the example. Open the Project Options dialog of the androidlcltest.lpi project and go to the section Paths and change the libraries path to reflect the correct paths of where your Android NDK was installed and where your,, etc, libraries are located for your target Android API level. For LCL-CustomDrawn-Android API level 8 is the best choice, because it supports Android 2.2+ like the LCL. The image below shows where to configure this:

Configure androidlcl libraries.jpg

The actual lazarus release contains a error, they create a - file instead of a .so - file. So you have to change this manually in lazarus.

Step 4 - Build the APK

If you are using Windows, use these instructions to build the APK: Custom Drawn Interface/Android#Step_4_-_Creating_the_APK_package_in_Windows

If you are using Linux follow these instructions instead: Before going to the command line to build the APK open the file lazarus/examples/androidlcl/android/ and change it to reflect your Android SDK path. The file says you should not modify it, but ignore that and modify it anyway. Here is how the file looks like:

# This file is automatically generated by Android Tools.
# Do not modify this file -- YOUR CHANGES WILL BE ERASED!
# This file must *NOT* be checked in Version Control Systems,
# as it contains information specific to your local configuration.

# location of the SDK. This is only used by Ant
# For customization when using a Version Control System, please read the
# header note.

After configuring that one, go to the command line and issue these commands:

 cd lazarus/examples/androidlcl/android
 ant debug

The APK will be located in lazarus/examples/androidlcl/android/bin

Step 5 - Install the APK in your phone and run it

You can install via ADB or by copying the file to the sdcard. You should see this:

lcl android 30 mar.png

How to create an LCL Android Application

To create a new LCL-CustomDrawn-Android application simply copy all of the file structure and build and java files from the example project called "androidlcl". This example can be obtained from the Lazarus source tree in lazarus/examples/androidlcl

Then you will need to modify the build files to change them to your new project name and your new Java package name.

Step 1 - Creating the LPI

You need a separate LPI at the moment for the Android version of the application but all the rest of the code can be shared. Create it using the template for a "Library" and then adapt the code from the example located in the lazarus source code in lazarus/examples/androidlcl

You need to adapt the exported JNI method names to your Android Package Name.

Step 2 - Building the library

First of all, build the Pascal executable without debug information. This debug information is not so useful in Android and makes the executable much bigger. Open the menu Project->Project Options and set the build mode, widgetset, architecture and operating system targets, as shown in these screenshots:

Android project options 1.png

Android project options 2.png

Android project options 3.png

Step 3 - Create the Android project structure

Besides the LCL project building, such as configuring a proper LPI and having a library main project file, one also needs to add all of the android project structure. Simply copy from the example project in lazarus/examples/androidlcl and adapt it to the new project. Things to change are the path to the SDK, the package name. The package name needs to be updated in the build files, in the directory structure android/src/packagename, in the activity java source code and also in the main library pascal source in the exports section.

Step 4 - Creating the APK package

Step 4 - Creating the APK package in Linux

To create the APK package in Linux simply go to the directory "android" inside the project folder and issue the command "ant debug". The package will be in android/bin/MyProject.apk

cd myproject/android ant debug

Ant and all dependencies must be installed using the package management of your linux distribution.

Step 4 - Creating the APK package in Windows



In Windows we provide a APK build system which uses only the tools provided in the Android SDK and therefore does not require ANT.

First it is necessary to create a debug key to use. To do this use this script:


which can be copied from the example application to your own project folder.

it contains following:

REM Adjust these paths to yours
SET PATH=C:\Programme\Android\android-sdk\tools;C:\Programme\Android\android-sdk\platform-tools\;C:\Programme\Java\jdk1.6.0_38\bin
SET APP_NAME=androidlcltest
SET ANDROID_HOME=C:\Programme\Android\android-sdk
SET APK_SDK_PLATFORM=C:\Programme\Android\android-sdk\platforms\android-9
SET APK_PROJECT_PATH=C:\Programme\lazarus\examples\androidlcl\android

mkdir bin

keytool --help

keytool -genkey -v -keystore bin\LCLDebugKey.keystore -alias LCLDebugKey -keyalg RSA -validity 10000

REM call and pause together allow us to see the results in the end

You have to fix everything after SET to your own paths. Don't forget adjusting the android version from APK_SDK_PLATFORM!

After generating the key, use the other script:


To build the APK file. Also remember to edit this batch file to reflect your paths.

This script contains the following:

REM Adjust these paths to yours
SET PATH=C:\Programme\Android\android-sdk\tools;C:\Programme\Android\android-sdk\platform-tools\;C:\Programme\Java\jdk1.6.0_38\bin
SET APP_NAME=androidlcltest
SET ANDROID_HOME=C:\Programme\Android\android-sdk
SET APK_SDK_PLATFORM=C:\Programme\Android\android-sdk\platforms\android-9
SET APK_PROJECT_PATH=C:\lazarus\examples\androidlcl\android 

REM Create necessary directory Structure
mkdir bin
mkdir bin\classes
mkdir gen
mkdir gen\com
mkdir gen\com\pascal
mkdir gen\com\pascal\lcltest
mkdir raw
mkdir raw\lib
mkdir raw\lib\armeabi

REM Cleanup
del bin\%APP_NAME%.ap_
del bin\%APP_NAME%.apk
del raw\lib\armeabi\*.so

REM More directory preparation
copy libs\armeabi\*.so raw\lib\armeabi\ 

REM Resource compilation
call aapt p -v -f -M AndroidManifest.xml -F bin\%APP_NAME%.ap_ -I %APK_SDK_PLATFORM%\android.jar -S res -m -J gen raw

REM Java compiler
call javac -verbose -classpath %APK_SDK_PLATFORM%\android.jar -d bin\classes src\com\pascal\lcltest\

REM DX to convert the java bytecode to dalvik bytecode
call dx --dex --verbose --output=%APK_PROJECT_PATH%\bin\classes.dex %APK_PROJECT_PATH%\bin\classes 

REM It seams that dx calls echo off
@echo on
REM Now build the unsigned APK
del %APK_PROJECT_PATH%\bin\%APP_NAME%-unsigned.apk
call apkbuilder %APK_PROJECT_PATH%\bin\%APP_NAME%-unsigned.apk -v -u -z %APK_PROJECT_PATH%\bin\%APP_NAME%.ap_ -f %APK_PROJECT_PATH%\bin\classes.dex

REM Generating on the fly a debug key
rem keytool -genkey -v -keystore bin\LCLDebugKey.keystore -alias LCLDebugKey -keyalg RSA -validity 10000 -dname NAME -storepass senhas  -keypass senhas

REM Signing the APK with a debug key
del bin\%APP_NAME%-unaligned.apk
REM Change keypass and storepass pw                        here|         and here|
jarsigner -verbose -keystore bin\LCLDebugKey.keystore -keypass senhas -storepass senhas -signedjar bin\%APP_NAME%-unaligned.apk  bin\%APP_NAME%-unsigned.apk LCLDebugKey

REM Align the final APK package
zipalign -v 4 bin\%APP_NAME%-unaligned.apk bin\%APP_NAME%.apk 

REM call and pause together allow us to see the results in the end

Don't forget changing the set-variables in the top AND change the pw (see above where).

Building an LCL Android application with debug info

It is useful to add another Android build mode which has debug info. Use all of the same options as shown above, except for the debug information:

Android project options 4.png

Oh no! My LCL Android application doesn't work

There are various reasons why the app may not work. The most important thing to do when an app doesn't work is to open the logcat and see what the log says. This can be done by running this command line command:

./adb logcat

And then test one of the hypotheses in the next subsections.

The Pascal executable was compiled for a wrong architecture, operating system and/or widgetset

This is the leading cause of executables not running. Always verify that you compiled the program to the "android" widgetset, "linux" operating system and "arm" architecture. This is done by going into the menu Project->Project Options. Then set these in the dialog all options as explained in this section:


To check if you library is arm-linux or not, execute the following commands:

cd libs/armeabi
ls -l

If it mentions anything like 80386 or gtk, then your program was compiled for linux-x86 and gtk2, not for Android like it should.

My Pascal application crashed. How to get a stacktrace?

If a Pascal application crashes you should use the command "adb logcat" to obtain the stack

Read also this thread in the Google NDK group about converting addresses to lines:

The indispensable build options

  • -Xd This build option is indispensable when cross-compiling from x86-linux to Android or else FPC will try to link the application against for example /usr/lib/ instead of the in the NDK, even if you specify a -Fl library path
  • -CpARMV6 This build option is indispensable because code generated for older ARM versions is unsupported by Android and might crash in some devices. See
  • -dAndroid in the package LCLBase.lpk
  • -Parm -Tlinux for the process and target operating system
  • -Fl should contain the path to the NDK directory with the target link shared object, such as,,, etc

Wrong package name

If you change the package name of the project, then you need to adapt the main project file to inform the widgetset of the change. In the example project this is done in the main project file, androidlcltest.lpr in this part:

CDWidgetset.ActivityClassName := 'com/pascal/lcltest/LCLActivity';

If your new package name is com.pascal.myapp, then you should change the command above to this:

CDWidgetset.ActivityClassName := 'com/pascal/myapp/LCLActivity';

Free Pascal Bugs on Android Support

The following summarizes the state of Android Support in Free Pascal:

We are in contact with FPC developers to fix the situation as can be seen in:

FPC4Android Branches

Because of FPC bugs related to Android support I have rolled my own branches.

FPC4Android 2.5.1

FPC4Android 2.5.1 has the following fixes applied to it:

And I have created a pre-compiled x86-linux -> android-arm cross-compiler and hosted it here (it is the -v2 cross-compiler);

To download the source execute:

svn co fpc4android

FPC4Android 2.6.1

This branch is not finished, it lacks patches to fix Android support, patches are welcome. SVN link:

svn co fpc4android_2_6

Android SDK and NDK bugs

Android NDK for Windows broken linker

The linker in android-ndk-r7b (path C:\Programas\android-ndk-r7\toolchains\arm-linux-androideabi-4.4.3\prebuilt\windows\bin\arm-linux-androideabi-ld.exe) crashes for no reason while linking LCL apps =( The linker from android-ndk-r7 and r5 work correctly.


Error while calling DX: Trouble processing: bad class file magic (cafebabe)

If while using the build script you get the following errors:

D:\djsystem\djpalm\android>call dx --dex --verbose --output=D:\djsystem\djpalm\a
ndroid\bin\classes.dex D:\djsystem\djpalm\android\bin\classes
processing D:\djsystem\djpalm\android\bin\classes\.\com\pascal\djpalm\LCLActivit

trouble processing:
bad class file magic (cafebabe) or version (0033.0000)
...while parsing com/pascal/djpalm/LCLActivity$1.class
...while processing com/pascal/djpalm/LCLActivity$1.class
processing D:\djsystem\djpalm\android\bin\classes\.\com\pascal\djpalm\LCLActivit

trouble processing:
bad class file magic (cafebabe) or version (0033.0000)
...while parsing com/pascal/djpalm/LCLActivity$2.class
...while processing com/pascal/djpalm/LCLActivity$2.class
processing D:\djsystem\djpalm\android\bin\classes\.\com\pascal\djpalm\LCLActivit

This probably means that you are using JDK 7. Unfortunatelly the current Android SDK r20 is not compatible with JDK 7, only with JDK 5 and 6. Please install JDK 6 and use that instead. See:

Development Notes

The mysterious JNI Crash

See the thread:

The problem was that vm^^.GetEnv would crash in HTC Wildfire, Alcatel and in the emulator with SIGILL but not in Xperia Mini, HTC Desire HD, Motorola Atrix and other smartphones.

The answer was that one needs to specify -CpARMV6 when building because older instructions might fail in some devices

NDK Libraries available in Android 2.2 (API level 8)

LCL-CustomDrawn targets Android 2.2+ and in this API level the following libraries are supported by the NDK:

  2. (linker)
  3. OpenGL ES 1
  4. OpenGL ES 2

LCL-CustomDrawn-Android uses and at the moment.

Native text drawing

Native text drawing is a bit convoluted in Android and the documentation is quite bad too. Some gotchas already found:

  • It draws text starting on a Y coordinate which represents the baseline, which is the bottom of strings like "abc", but not the bottom of strings like "qg". See
  • There is no documentation about what the size in Paint.setTextSize represents. Some people say it is pixels, but to me it looks something else because it seams to differ across devices.

But there are also good things about it:

  • It can draw on a transparent bitmap and use alpha transparency to implement anti-aliasing and subpixel rendering. The text gets quite beaultiful.
  • It can draw on the ARGB 32-bits non-premultiplied format which is a pretty good one

Flood of garbage collector messages when the caret is visible

Something like this:

D/dalvikvm( 6364): GC_EXTERNAL_ALLOC freed 188 objects / 6664 bytes in 94ms
D/dalvikvm( 6364): GC_EXTERNAL_ALLOC freed 170 objects / 6160 bytes in 78ms
D/dalvikvm( 6364): GC_EXTERNAL_ALLOC freed 162 objects / 5904 bytes in 82ms
D/dalvikvm( 6364): GC_EXTERNAL_ALLOC freed 162 objects / 5856 bytes in 78ms
D/dalvikvm( 6364): GC_EXTERNAL_ALLOC freed 162 objects / 5872 bytes in 80ms
D/dalvikvm( 2825): GC_EXPLICIT freed 371 objects / 18480 bytes in 91ms
D/dalvikvm( 6364): GC_EXTERNAL_ALLOC freed 162 objects / 5896 bytes in 78ms
D/dalvikvm( 6364): GC_EXTERNAL_ALLOC freed 162 objects / 5896 bytes in 78ms
D/dalvikvm( 6364): GC_EXTERNAL_ALLOC freed 162 objects / 5896 bytes in 81ms
D/dalvikvm( 6364): GC_EXTERNAL_ALLOC freed 162 objects / 5920 bytes in 78ms
D/dalvikvm( 6364): GC_EXTERNAL_ALLOC freed 162 objects / 5920 bytes in 83ms

In my investigation this happens probably because the TCDEdit will request a full control invalidate on each timer tick, which currently will main a full form invalidate, so the GC needs to collect the bitmaps and other paint objects when painting that often.

Why the caret of a TEdit keeps blinking after clicking on the form

When clicking on the form the LCL focus will refuse to move from the Edit to the Form because this behavior seems to be hard coded in the LCL, although maybe we might change this for Android. So even while we set focus into the form, the LCL refuses to do that and keeps its focus in the Edit, thus we have a focus mismatch. This might eventually be fixed in the future.

Android ComboBox

For adding Android combobox support a new method was added to LCLIntf along with a global variable to store the callback of this dialog:

  OnShowSelectItemDialogResult: TOnShowSelectItemDialogResult;

function ShowSelectItemDialog(const AItems: TStrings): Boolean; override;

This method will run a native item selection dialog, if the platform has one, or result false without doing anything otherwise.

Android combobox.png

Using the Native ListView Dialog

To allow the user to select items from a list more easily we offer a routine which launch dialog with the native ListView.

{$ifdef LCLCustomDrawn}
uses customdrawnint, lclintf;

procedure TForm2.Button3Click(Sender: TObject);
{$ifdef LCLCustomDrawn}
  LCLIntf.OnListViewDialogResult := @MyOnListViewDialogResult;
  CDWidgetSet.ShowListViewDialog('Dialog Title',
    ['Title1', 'Title2', 'Title3', 'Title4', 'Title5', 'Title6'],
    ['Descr1', 'Descr2', 'Descr3', 'Descr4', 'Descr5', 'Descr6']);

procedure TForm2.MyOnListViewDialogResult(ASelectedItem: Integer);
  DebugLn(Format('[MyOnListViewDialogResult] ASelectedItem=%d', [ASelectedItem]));

LCLIntf.OnListViewDialogResult will be called with the selected item, with a zero-based index, or -1 if the dialog was cancelled by the user. One way to cancel the dialog is when the user pressed the back button.

Note that there are 2 more parameters in the end of this routine with default values, which allow choosing the color for the odd and the other for the even rows. The color is an integer of 32-bits in the ARGB format, don't use TColor here!

procedure TCDWidgetSet.ShowListViewDialog(ATitle: string; ATitles,
  ADescriptions: array of string;
  AColorOddRow: jint = $ff292C29; AColorEvenRow: jint = $ff424542);

Android ListView.png


See: LazDeviceAPIs