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