Sign in Join
Wiki copytemporary

Android Build APK/ru: what changed

Revision 3 to 4. Removed lines have a minus sign; added lines have a plus sign.

OldNewLine
11Данная статья освещает способ как скомпилировать проект на FPC и загрузить его на андроид устройство.
22
33Подразумевается, что проект являет собой NDK библиотеку, которая загрузается в Java коде. Так же, данный способ не привязан к какому либо расширению IDE (например Android4Laz) и может использовать отдельно для произвольных проектов.
44
55## Требования
66
77- FPC (с готовыми [[Android/ru|Android rtl]] библиотеками).
88- JRE (Java-Run Time) - нужен для JDK, а так же, для запуска "java" машины (для исполнения утилит входящийх в состав Android SDK)
99- JDK (необходим для установки **javac**), JDK потребует установки JRE.
1010- Android NDK
1111- Android SDK
1212
1313Никаких дополнительнех средств сборкт (например ant) не требуется
1414
1515### Версия JRE/JDK
1616
1717На данный момент (зима 2017) официально доступна для скачивания только версия 8 (1.8). Ранее можно было скачать версию 7. Многие компоненты Android SDK привязаны к конкретной версии JDK.
1818
1919## Сборка
2020
21210\. Предполагается, что весь проект лежит в некоторой папке, например "mydemo". А все скрипты и утилиты для сборки под android находятся в "mydemo\android". Это имеет значение только на следующем шаге, где указан ключ -FE.
2222
23231\. необходимо скомпилировать проект (библиотеку). Командная строка (windows)может выглядеть таким образом.
2424
25-```
25+```text
2626C:\FPC\3.1.1\bin\i386-win32\fpc.exe ^
2727 -Tandroid -Parm -MDelphi ^
2828 -Scghi -CX -O3 -Xs -XX -l -vbq ^
2929 -FUlib\arm-android ^
3030 -oandroid\mydemo.so ^
3131 -FE.\android\files\lib\armeabi\ ^
3232 -CpARMv6 -CfVFPv2 -Xd -XParm-linux-androideabi- ^
3333 -FDC:\android\ndk-r11c\toolchains\arm-linux-androideabi-4.9\prebuilt\windows\bin ^
3434 -FuC:\android\ndk-r11c\platforms\android-9\arch-arm\usr\lib ^
3535 mydemo.lpr
3636```
3737
3838На что следует обратить внимание. Ключи
3939
4040- -FD - указывает путь, где хранятся утилиты сборки
4141- -XParm-linux-androideabi- - указывает префикс для утилит сборки
4242- -Fu - указывающие на библиотеки NDK - необходимы для компоновки
4343- -FE - указывает путь, куда следует записать созданную библиотеку. Конечная директория в данном случае указана как "lib\armeabi". Этот путь будет сохранится в самом apk. Он должен быть именно таким, т.к. он привязан к целевой архитектуре (arm). Для arm64 или arm7 путь должен быть иным. Все сторонние динамические библиотеки для ARM архитектуры, так же должны находится в папке lib\armeabi.
4444
45452\. подготовить файл-манифест AndroidManifest.xml
4646
47473\. создать .apk файл
4848
49-```
49+```text
5050set buildtoolsdir=C:\android\sdk-windows\build-tools\23.0.3
5151set APP_NAME=testapp
5252set APK_SDK_PLATFORM=C:\android\sdk-windows\platforms\android-11
5353
5454rem -S res - fails, if "res" directory doesn't exist
5555rem enerate-dependencies is needed to generate R.java file
5656%buildtoolsdir%\aapt p -v -f -M AndroidManifest.xml ^
5757 -F bin\%APP_NAME%.ap_ ^
5858 --generate-dependencies ^
5959 -I %APK_SDK_PLATFORM%\android.jar -S res -m -J gen ^
6060 files
6161```
6262
6363утилита создаёт файл начальный .apk файл (-F bin\\%APP_NAME%.ap_ - расширение указано как "ap_" намеренно, т.к. это не итоговый файл), а так же R.java файл в папке "gen" (-J gen). При создании apk (по сути .zip) файла, будут включена папка "files". (на шаге №1 в неё был скопилированы библиотека "-FE.\android\files\lib\armeabi\\", таким образом "lib\armeabi\mydemo.so" попадёт в apk файл) "-S" указывает папку со стандартными андроид ресурсами (иконки и layout xml-ы), папка будет скопирована в .apk
6464
6565Структура сгенерированного .apk файла будет выглядеть так:
6666
67-```
67+```text
6868AndroidManifest.xml
6969resources.arsc
7070res
7171lib
7272lib\armeabi
7373...все другие папки/файлы которые были расположены в "files"
7474```
7575
7676Если у программы есть какие-либо ресусрные файлы, то они должны быть добавлены в "files" непосредственно ПЕРЕД вызовом "aapt". Копировать их в "files" тоже не обязательно (как и использовать папку "files"), т.к. можно указать несколько папок-источников, например так:
7777
78-```
78+```text
7979%buildtoolsdir%\aapt ... ^
8080 dir1 dir2 dir3
8181```
8282
83834\. скомпилировать Java код основной программы
8484
8585``` pascal
8686set jdkbindir=C:\Program Files\Java\jdk1.7.0_25\bin
8787set androidjar=C:\android\sdk-windows\platforms\android-11\android.jar
8888
8989"%jdkbindir%\javac.exe" ^
9090 .\zengl\android\ZenGL.java ^
9191 .\zengl\demo01\Demo01Activity.java ^
9292 -cp "%androidjar%" ^
9393 -d .\classes
9494```
9595
9696Важно - указать "-cp" (class-path) для используемой Андроид-СДК. Компилятор java, как и сам jdk, ничего об андроид системе не знают. А компилируемая программа, будет использовать классы SDK. По-этому если class-path не указать, то будут сыпаться ошибки о том, что не объявлен класс и т.д. -d - указывает путь, куда положить скомпилированные .class файлы, они необходимы на следующем шаге.
9797
9898- На дальнейшем шаге скомпилированный код, должен быть преобразован в Dalvik. Возможно, что версия "dx.jar" ожидаен классы версии 1.7, а не 1.8 (которую вы можете использовать). В этом случае, необходимо javac необходимо указать версию совместимости:
9999
100100``` pascal
101101set jdkbindir=C:\Program Files\Java\jdk1.8.0_25\bin
102102set androidjar=C:\android\sdk-windows\platforms\android-11\android.jar
103103
104104"%jdkbindir%\javac.exe" ^
105105 .\zengl\android\ZenGL.java ^
106106 .\zengl\demo01\Demo01Activity.java ^
107107 -cp "%androidjar%" ^
108108 -d .\classes -target 1.7 -source 1.7
109109```
110110
1111115\. сконвертировать Java код в dalvik
112112
113-```
113+```text
114114SET DX_PATH=C:\android\sdk-windows\build-tools\23.0.3\lib
115115
116116java -Djava.ext.dirs=%DX_PATH%\ -jar %DX_PATH%\dx.jar --dex --verbose --output=.\bin\classes.dex .\classes
117117```
118118
119119Конвертирация java-класс файлов в далвик файлы.
120120
1211216\. создать не подписанный .apk файл, добавив dalvik класс-файлы
122122
123123``` pascal
124124set jdkdir=C:\Program Files\Java\jdk1.7.0_25\bin
125125set ANDROID_HOME=C:\android\sdk-windows
126126set APK_PROJECT_PATH=.
127127set APP_NAME=testapp
128128
129129del %APK_PROJECT_PATH%\bin\%APP_NAME%-unsigned.apk
130130"%jdkdir%\java" -classpath %ANDROID_HOME%\tools\lib\sdklib.jar ^
131131 com.android.sdklib.build.ApkBuilderMain ^
132132 %APK_PROJECT_PATH%\bin\%APP_NAME%-unsigned.apk -v -u ^
133133 -z %APK_PROJECT_PATH%\bin\%APP_NAME%.ap_ ^
134134 -f %APK_PROJECT_PATH%\bin\classes.dex
135135```
136136
137137На момент написания скрипта, отдельной утилиты для добавления classes.dex в .apk файл не было... Но здесь происходит вызов вызов ApkBuilderMain (через вызов java машины). Единственное что он делает, это добавляет classes.dex (созданный на шаге №5) в корневую папку существующего .apk файла (созданного на шаге №3 .ap_) и записывает в файл -unsigned.apk. Обычная zip утилита (например 7z), скорей всего, справилась бы не хуже.
138138
1391397\. Подписать .apk файл. Внимание! данный скрипт генерирует новый само-подписанный ключ каждый раз. Программа загружаемая на Google Play должна использовать настоящий ключ (это так же важно при дальнейшем обновлении программы)
140140
141141``` pascal
142142set jdkbindir=C:\Program Files\Java\jdk1.7.0_25\bin
143143set APP_NAME=testapp
144144
145145REM Generating on the fly a debug key
146146"%jdkbindir%\keytool" -genkeypair -v -keystore bin\LCLDebugBKKey.keystore -alias LCLDebugBKKey ^
147147 -keyalg RSA -validity 10000 ^
148148 -dname "cn=Havefunsoft, o=company, c=US" ^
149149 -storepass "123456" -keypass "123456" -keysize 2048
150150
151151REM Signing the APK with a debug key
152152del bin\%APP_NAME%-unaligned.apk
153153"%jdkbindir%\jarsigner" -verbose ^
154154 -sigalg SHA1withRSA ^
155155 -digestalg SHA1 ^
156156 -keystore bin\LCLDebugBKKey.keystore -keypass 123456 -storepass 123456 ^
157157 -signedjar bin\%APP_NAME%-unaligned.apk bin\%APP_NAME%-unsigned.apk LCLDebugBKKey
158158```
159159
1601607.1 проверка подписи. (шаг опциональный)
161161
162162``` pascal
163163set jdkbindir=C:\Program Files\Java\jdk1.7.0_25\bin
164164set APP_NAME=testapp
165165
166166REM Signing the APK with a debug key
167167"%jdkbindir%\jarsigner" -verify -verbose -certs bin\%APP_NAME%-unaligned.apk
168168```
169169
1701708\. Выровнять результирующий .apk. (Выравнивние должно происходить ПОСЛЕ подписи, т.к. подпись делает apk файл не выровнянным)
171171
172-```
172+```text
173173set APP_NAME=testapp
174174set buildtoolsdir=C:\android\sdk-windows\build-tools\23.0.3
175175
176176REM Align the final APK package
177177%buildtoolsdir%\zipalign -v 4 bin\%APP_NAME%-unaligned.apk bin\%APP_NAME%.apk
178178```
179179
180180По завершению 8-ого шага, результирующий .apk файл может быть загружен непосредственно на устройство.
181181
1821829\. Загрузка любой .apk файл можно загрузить на устройство, если оно подлюкчено по USB и на нём разрешены права разработчика. В состав SDK входит утилита adb, которая позволяет удалить приложение и установить новый .apk. (Если приложение уже установлено, то новый .apk загружен не будет, и предварительно его нужно удалять с помощью uninstall)
183183
184-```
184+```text
185185C:\android\sdk-windows\platform-tools\adb.exe uninstall zengl.demo01
186186C:\android\sdk-windows\platform-tools\adb.exe install bin\testapp.apk
187187```
188188
189189## Смотри также
190190
191191- [[Android/ru|Кросс-компилятор]] инструкции по сборке кросс-компилятора на Андроид
192192
193193---
194194*From the Free Pascal wiki, page "Android Build APK/ru", as it stood on 2020-08-06 after a change by Trev, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).*
195195Category: Android/ru
196196Category: FPC

Back to history