Android Build APK/ru: what changed
Revision 0 to 1. Removed lines have a minus sign; added lines have a plus sign.
Title: Android Build APK/ru
| Old | New | Line | |
|---|---|---|---|
| 1 | + | Данная статья освещает способ как скомпилировать проект на FPC и загрузить его на андроид устройство. | |
| 2 | + | ||
| 3 | + | Подразумевается, что проект являет собой NDK библиотеку, которая загрузается в Java коде. Так же, данный способ не привязан к какому либо расширению IDE (например Android4Laz) и может использовать отдельно для произвольных проектов. | |
| 4 | + | ||
| 5 | + | ## Требования | |
| 6 | + | ||
| 7 | + | - FPC (с готовыми [[Android/ru|Android rtl]] библиотеками). | |
| 8 | + | - JRE (Java-Run Time) - нужен для JDK, а так же, для запуска "java" машины (для исполнения утилит входящийх в состав Android SDK) | |
| 9 | + | - JDK (необходим для установки **javac**), JDK потребует установки JRE. | |
| 10 | + | - Android NDK | |
| 11 | + | - Android SDK | |
| 12 | + | ||
| 13 | + | Никаких дополнительнех средств сборкт (например ant) не требуется | |
| 14 | + | ||
| 15 | + | ### Версия JRE/JDK | |
| 16 | + | ||
| 17 | + | На данный момент (зима 2017) официально доступна для скачивания только версия 8 (1.8). Ранее можно было скачать версию 7. Многие компоненты Android SDK привязаны к конкретной версии JDK. | |
| 18 | + | ||
| 19 | + | ## Сборка | |
| 20 | + | ||
| 21 | + | 0\. Предполагается, что весь проект лежит в некоторой папке, например "mydemo". А все скрипты и утилиты для сборки под android находятся в "mydemo\android". Это имеет значение только на следующем шаге, где указан ключ -FE. | |
| 22 | + | ||
| 23 | + | 1\. необходимо скомпилировать проект (библиотеку). Командная строка (windows)может выглядеть таким образом. | |
| 24 | + | ||
| 25 | + | `C:\FPC\3.1.1\bin\i386-win32\fpc.exe ^`\ | |
| 26 | + | ` -Tandroid -Parm -MDelphi ^`\ | |
| 27 | + | ` -Scghi -CX -O3 -Xs -XX -l -vbq ^`\ | |
| 28 | + | ` -FUlib\arm-android ^`\ | |
| 29 | + | ` -oandroid\mydemo.so ^`\ | |
| 30 | + | ` -FE.\android\files\lib\armeabi\ ^`\ | |
| 31 | + | ` -CpARMv6 -CfVFPv2 -Xd -XParm-linux-androideabi- ^`\ | |
| 32 | + | ` -FDC:\android\ndk-r11c\toolchains\arm-linux-androideabi-4.9\prebuilt\windows\bin ^`\ | |
| 33 | + | ` -FuC:\android\ndk-r11c\platforms\android-9\arch-arm\usr\lib ^`\ | |
| 34 | + | ` mydemo.lpr` | |
| 35 | + | ||
| 36 | + | На что следует обратить внимание. Ключи | |
| 37 | + | ||
| 38 | + | - -FD - указывает путь, где хранятся утилиты сборки | |
| 39 | + | - -XParm-linux-androideabi- - указывает префикс для утилит сборки | |
| 40 | + | - -Fu - указывающие на библиотеки NDK - необходимы для компоновки | |
| 41 | + | - -FE - указывает путь, куда следует записать созданную библиотеку. Конечная директория в данном случае указана как "lib\armeabi". Этот путь будет сохранится в самом apk. Он должен быть именно таким, т.к. он привязан к целевой архитектуре (arm). Для arm64 или arm7 путь должен быть иным. Все сторонние динамические библиотеки для ARM архитектуры, так же должны находится в папке lib\armeabi. | |
| 42 | + | ||
| 43 | + | 2\. подготовить файл-манифест AndroidManifest.xml | |
| 44 | + | ||
| 45 | + | 3\. создать .apk файл | |
| 46 | + | ||
| 47 | + | `set buildtoolsdir=C:\android\sdk-windows\build-tools\23.0.3`\ | |
| 48 | + | `set APP_NAME=testapp`\ | |
| 49 | + | `set APK_SDK_PLATFORM=C:\android\sdk-windows\platforms\android-11`\ | |
| 50 | + | \ | |
| 51 | + | `rem -S res - fails, if "res" directory doesn't exist`\ | |
| 52 | + | `rem enerate-dependencies is needed to generate R.java file`\ | |
| 53 | + | `%buildtoolsdir%\aapt p -v -f -M AndroidManifest.xml ^`\ | |
| 54 | + | ` -F bin\%APP_NAME%.ap_ ^`\ | |
| 55 | + | ` --generate-dependencies ^`\ | |
| 56 | + | ` -I %APK_SDK_PLATFORM%\android.jar -S res -m -J gen ^`\ | |
| 57 | + | ` files` | |
| 58 | + | ||
| 59 | + | утилита создаёт файл начальный .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 | |
| 60 | + | ||
| 61 | + | Структура сгенерированного .apk файла будет выглядеть так: | |
| 62 | + | ||
| 63 | + | `AndroidManifest.xml `\ | |
| 64 | + | `resources.arsc`\ | |
| 65 | + | `res`\ | |
| 66 | + | `lib`\ | |
| 67 | + | `lib\armeabi`\ | |
| 68 | + | `...все другие папки/файлы которые были расположены в "files"` | |
| 69 | + | ||
| 70 | + | Если у программы есть какие-либо ресусрные файлы, то они должны быть добавлены в "files" непосредственно ПЕРЕД вызовом "aapt". Копировать их в "files" тоже не обязательно (как и использовать папку "files"), т.к. можно указать несколько папок-источников, например так: | |
| 71 | + | ||
| 72 | + | `%buildtoolsdir%\aapt ... ^`\ | |
| 73 | + | ` dir1 dir2 dir3`\ | |
| 74 | + | ` ` | |
| 75 | + | ||
| 76 | + | 4\. скомпилировать Java код основной программы | |
| 77 | + | ||
| 78 | + | `set jdkbindir=C:\Program Files\Java\jdk1.7.0_25\bin`\ | |
| 79 | + | `set androidjar=C:\android\sdk-windows\platforms\android-11\android.jar `\ | |
| 80 | + | \ | |
| 81 | + | `"%jdkbindir%\javac.exe" ^`\ | |
| 82 | + | ` .\zengl\android\ZenGL.java ^`\ | |
| 83 | + | ` .\zengl\demo01\Demo01Activity.java ^`\ | |
| 84 | + | ` -cp "%androidjar%" ^`\ | |
| 85 | + | ` -d .\classes` | |
| 86 | + | ||
| 87 | + | Важно - указать "-cp" (class-path) для используемой Андроид-СДК. Компилятор java, как и сам jdk, ничего об андроид системе не знают. А компилируемая программа, будет использовать классы SDK. По-этому если class-path не указать, то будут сыпаться ошибки о том, что не объявлен класс и т.д. -d - указывает путь, куда положить скомпилированные .class файлы, они необходимы на следующем шаге. | |
| 88 | + | ||
| 89 | + | - На дальнейшем шаге скомпилированный код, должен быть преобразован в Dalvik. Возможно, что версия "dx.jar" ожидаен классы версии 1.7, а не 1.8 (которую вы можете использовать). В этом случае, необходимо javac необходимо указать версию совместимости: | |
| 90 | + | ||
| 91 | + | `set jdkbindir=C:\Program Files\Java\jdk1.8.0_25\bin`\ | |
| 92 | + | `set androidjar=C:\android\sdk-windows\platforms\android-11\android.jar `\ | |
| 93 | + | \ | |
| 94 | + | `"%jdkbindir%\javac.exe" ^`\ | |
| 95 | + | ` .\zengl\android\ZenGL.java ^`\ | |
| 96 | + | ` .\zengl\demo01\Demo01Activity.java ^`\ | |
| 97 | + | ` -cp "%androidjar%" ^`\ | |
| 98 | + | ` -d .\classes -target 1.7 -source 1.7` | |
| 99 | + | ||
| 100 | + | 5\. сконвертировать Java код в dalvik | |
| 101 | + | ||
| 102 | + | `SET DX_PATH=C:\android\sdk-windows\build-tools\23.0.3\lib`\ | |
| 103 | + | \ | |
| 104 | + | `java -Djava.ext.dirs=%DX_PATH%\ -jar %DX_PATH%\dx.jar --dex --verbose --output=.\bin\classes.dex .\classes` | |
| 105 | + | ||
| 106 | + | Конвертирация java-класс файлов в далвик файлы. | |
| 107 | + | ||
| 108 | + | 6\. создать не подписанный .apk файл, добавив dalvik класс-файлы | |
| 109 | + | ||
| 110 | + | `set jdkdir=C:\Program Files\Java\jdk1.7.0_25\bin`\ | |
| 111 | + | `set ANDROID_HOME=C:\android\sdk-windows`\ | |
| 112 | + | `set APK_PROJECT_PATH=.`\ | |
| 113 | + | `set APP_NAME=testapp`\ | |
| 114 | + | \ | |
| 115 | + | `del %APK_PROJECT_PATH%\bin\%APP_NAME%-unsigned.apk`\ | |
| 116 | + | `"%jdkdir%\java" -classpath %ANDROID_HOME%\tools\lib\sdklib.jar ^`\ | |
| 117 | + | ` com.android.sdklib.build.ApkBuilderMain ^`\ | |
| 118 | + | ` %APK_PROJECT_PATH%\bin\%APP_NAME%-unsigned.apk -v -u ^`\ | |
| 119 | + | ` -z %APK_PROJECT_PATH%\bin\%APP_NAME%.ap_ ^`\ | |
| 120 | + | ` -f %APK_PROJECT_PATH%\bin\classes.dex` | |
| 121 | + | ||
| 122 | + | На момент написания скрипта, отдельной утилиты для добавления classes.dex в .apk файл не было... Но здесь происходит вызов вызов ApkBuilderMain (через вызов java машины). Единственное что он делает, это добавляет classes.dex (созданный на шаге №5) в корневую папку существующего .apk файла (созданного на шаге №3 .ap_) и записывает в файл -unsigned.apk. Обычная zip утилита (например 7z), скорей всего, справилась бы не хуже. | |
| 123 | + | ||
| 124 | + | 7\. Подписать .apk файл. Внимание! данный скрипт генерирует новый само-подписанный ключ каждый раз. Программа загружаемая на Google Play должна использовать настоящий ключ (это так же важно при дальнейшем обновлении программы) | |
| 125 | + | ||
| 126 | + | `set jdkbindir=C:\Program Files\Java\jdk1.7.0_25\bin`\ | |
| 127 | + | `set APP_NAME=testapp`\ | |
| 128 | + | \ | |
| 129 | + | `REM Generating on the fly a debug key`\ | |
| 130 | + | `"%jdkbindir%\keytool" -genkeypair -v -keystore bin\LCLDebugBKKey.keystore -alias LCLDebugBKKey ^`\ | |
| 131 | + | ` -keyalg RSA -validity 10000 ^`\ | |
| 132 | + | ` -dname "cn=Havefunsoft, o=company, c=US" ^`\ | |
| 133 | + | ` -storepass "123456" -keypass "123456" -keysize 2048`\ | |
| 134 | + | \ | |
| 135 | + | `REM Signing the APK with a debug key`\ | |
| 136 | + | `del bin\%APP_NAME%-unaligned.apk`\ | |
| 137 | + | `"%jdkbindir%\jarsigner" -verbose ^`\ | |
| 138 | + | ` -sigalg SHA1withRSA ^`\ | |
| 139 | + | ` -digestalg SHA1 ^`\ | |
| 140 | + | ` -keystore bin\LCLDebugBKKey.keystore -keypass 123456 -storepass 123456 ^`\ | |
| 141 | + | ` -signedjar bin\%APP_NAME%-unaligned.apk bin\%APP_NAME%-unsigned.apk LCLDebugBKKey` | |
| 142 | + | ||
| 143 | + | 7.1 проверка подписи. (шаг опциональный) | |
| 144 | + | ||
| 145 | + | `set jdkbindir=C:\Program Files\Java\jdk1.7.0_25\bin`\ | |
| 146 | + | `set APP_NAME=testapp`\ | |
| 147 | + | \ | |
| 148 | + | `REM Signing the APK with a debug key`\ | |
| 149 | + | `"%jdkbindir%\jarsigner" -verify -verbose -certs bin\%APP_NAME%-unaligned.apk` | |
| 150 | + | ||
| 151 | + | 8\. Выровнять результирующий .apk. (Выравнивние должно происходить ПОСЛЕ подписи, т.к. подпись делает apk файл не выровнянным) | |
| 152 | + | ||
| 153 | + | `set APP_NAME=testapp`\ | |
| 154 | + | `set buildtoolsdir=C:\android\sdk-windows\build-tools\23.0.3`\ | |
| 155 | + | \ | |
| 156 | + | `REM Align the final APK package`\ | |
| 157 | + | `%buildtoolsdir%\zipalign -v 4 bin\%APP_NAME%-unaligned.apk bin\%APP_NAME%.apk` | |
| 158 | + | ||
| 159 | + | По завершению 8-ого шага, результирующий .apk файл может быть загружен непосредственно на устройство. | |
| 160 | + | ||
| 161 | + | 9\. Загрузка любой .apk файл можно загрузить на устройство, если оно подлюкчено по USB и на нём разрешены права разработчика. В состав SDK входит утилита adb, которая позволяет удалить приложение и установить новый .apk. (Если приложение уже установлено, то новый .apk загружен не будет, и предварительно его нужно удалять с помощью uninstall) | |
| 162 | + | ||
| 163 | + | `C:\android\sdk-windows\platform-tools\adb.exe uninstall zengl.demo01`\ | |
| 164 | + | `C:\android\sdk-windows\platform-tools\adb.exe install bin\testapp.apk` | |
| 165 | + | ||
| 166 | + | ## Смотри также | |
| 167 | + | ||
| 168 | + | - [[Android/ru|Кросс-компилятор]] инструкции по сборке кросс-компилятора на Андроид | |
| 169 | + | ||
| 170 | + | --- | |
| 171 | + | *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).* | |
| 172 | + | Category: Android/ru | |
| 173 | + | Category: FPC |