Описание проекта
Данный проект представляет собой шаблон Android-приложения, включающего в себя минимальную версию интерпретатора текстовых квестов INSTEAD, и позволяющего запаковать вашу парсерную игру в APK-файл для запуска на телефоне.
"Парсерная игра" означает, что ваша игра должна быть написана с использованием модуля МЕТАПАРСЕР3.
Ваша игра будет выглядеть примерно так:
Как упаковать свою игру в APK-файл
Для начала вам необходимо клонировать репозиторий, либо скачать последний релиз со страницы Releases и распаковать куда-нибудь.
Примечание: в дальнейшем все пути к директориям я буду указывать относительно корневой директории этого проекта.
Скопируйте игру
Вам необходимо положить файлы вашей игры в директорию app/src/main/assets/game/. Так же не забудьте удалить из своей игры файл morphs.mrd.
Измените applicationId
В файле app/build.gradle вам необходимо изменить значение переменной applicationId на что-то своё. Обычно это домен вашего сайта "задом наперёд" плюс название приложения, например "com.mysite.mygame". Эта строка будет уникальным идентификатором приложения в телефоне и в Google Play (учтите, что после того как вы выложите приложение в маркет, поменять applicationId будет нельзя).
Измените версию игры
В файле app/build.gradle вам необходимо изменить значение переменных versionCode и versionName.
-
versionCodeэто целое положительное число, которое используется для определения более новой версии приложения: чем больше число, тем новее версия. С каждым обновлением игры в маркете вы должны увеличивать это значение (не обязательно по порядку). Максимальное значение 2100000000. -
versionNameстрока, используемая в качестве номера версии, которая будет показана пользователям. Например "1.3-beta"
Измените название игры
В файле app/src/main/res/values/strings.xml вам нужно изменить значение строки <string name="app_name">metaparser</string>. Вместо metaparser впишите название игры. Оно будет отображаться под иконкой на рабочем столе и в тулбаре игры.
Добавьте иконку для игры
Теперь необходимо добавить иконку для игры. А если точнее, то несколько иконок разных размеров для телефонов с различной плотностью пикселей на экране.
Проще всего их сгенерировать онлайн в Android Assets Studio или внутри Android Studio.
Так же начиная с Android 8 поддерживаются адаптивные иконки, которые могут быть в векторном формате.
Иконки нужно заменить в директориях app/src/main/res/mipmap-* (вместо * имеются ввиду: hdpi, mdpi, xhdpi, xxhdpi, xxxhdpi и anydpi-v26 для адаптивных иконок).
Измените цвета
Изменить цвет тулбара, статусбара и поля для ввода текста можно в файле app/src/main/res/values/colors.xml
Установите Android SDK и NDK
Для сборки приложения вам необходимо скачать Android SDK и Android NDK(для сборки из консоли), либо Android Studio(для любителей GUI).
Если вы выбрали Android Studio, то вам необходимо установить SDK и NDK по инструкции.
Создайте цифровой ключ
Каждый APK файл должен быть подписан вашим цифровым ключом. Создать себе ключ вы можете с помощью программы keytool которая входит в состав OpenJDK.
Что бы создать ключ выполните keytool -genkey -v -keystore keystore.jks -keyalg RSA -keysize 2048 -validity 10000 -alias key0
Теперь в корне нашего проекта переименуйте файл keystore.properties_example в keystore.properties и пропишите в нём путь к вашему ключу и пароли.
После этого система сборки будет автоматически подписывать этим ключом release версию вашей игры.
Важно: не потеряйте свой цифровой ключ и пароли от него, так как в этом случае вы больше не сможете обновлять свою игру в маркете.
Сборка APK
Что бы собрать приложение мы используем систему сборки Gradle. В корне нашего проекта есть файл gradlew, это скрипт который скачивает систему сборки и запускает команды для неё.
Что бы собрать APK вам нужно выполнить две команды:
./gradlew downloadDependencies -- скачивает архивы c исходниками Instead и Lua и распаковывает их в подкаталоги app/src/main/c/
./gradlew build -- собирает debug и release версии приложения. APK файлы вы сможете найти в каталоге app/build/outputs/apk/
Так же можно собирать debug и release версии по отдельности командами ./gradlew assembleDebug и ./gradlew assembleRelease
Что бы установить приложение на телефон можете воспользоваться командой ./gradlew installRelease
Что бы очистить директории сборки и начать с чистого листа есть команда ./gradlew clean
Полный список доступных команд можно посмотреть так ./gradlew list
После этого вы можете распространять release версию своего APK.