Skip to content

Набор скриптов для упрощения жизни Android разработчикам в Delphi XE5 и XE6

License

Notifications You must be signed in to change notification settings

naXa777/dex-explorer-kit

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 

Repository files navigation

DEX Explorer Kit

Это набор скриптов (bat) для упрощения жизни мобильным разработчикам в Delphi XE.
Основу составляет dex2jar - кроссплатформенный набор скриптов, предназначенный для конвертации dex файлов в class файлы. В данной инструкции описано как использовать DEX Explorer Kit для просмотра содержимого и модификации файла classes.dex.

Теория

APK - исполнимый файл Android приложения. По сути ZIP архив, внутри которого лежит classes.dex, AndroidManifest.xml, нативные библиотеки (.so) и пр. ресурсы. Embarcadero Delphi XE использует собственный classes.dex, который помещается в каждое Android приложение, собранное в этой IDE. Файл различается в разных версиях Delphi XE. Чтобы использовать Java классы или Java библиотеку в Android приложении на Delphi, нужно добавить их в classes.dex и подменить его в процессе сборки.

Декомпиляция — процесс воссоздания исходного кода декомпилятором.

Чтобы открыть командную строку в текущей папке, используйте SHIFT + клик правой кнопкой мыши -> Открыть командную строку здесь.

Декомпиляция DEX

  1. В командной строке вызвать: "<dex2jar_home>/d2j-dex2jar.bat <dex_path>", где
    dex2jar_home - путь к папке, в которую установлен dex2jar (в этом наборе ./decompile/dex2jar-2.0);
    dex_path - путь к файлу classes.dex.
  2. Открыть получившийся jar в программе-декомпиляторе java приложений (jd-gui, например), чтобы увидеть исходники.
    JD-GUI не входит в этот набор, но её можно скачать с сайта разработчика http://jd.benow.ca/

Используемая в наборе версия пакета dex2jar 2.0. Перед началом работы рекомендуется проверить наличие новой версии здесь https://sourceforge.net/projects/dex2jar.

Добавление своего Java класса

  1. Разместить исходники класса внутри папки src.
  2. Разместить classes.dex в папке lib.
    Если во время исполнения скрипта файл classes.dex не будет обнаружен в папке lib, будет использоваться classes.dex от Embarcadero (к нему необходимо указать путь - EMBO_DEX)
  3. Внести изменения в build.bat: указать путь к *.java файлам. Найти и заменить src\com\company\package\*.java в 28 строке файла build.bat.
  4. Запустить ./build.bat из командной строки (находясь в папке compile, содержащей этот файл).
    Результатом слияния, если оно прошло успешно, будет output\dex\classes.dex.
  5. Если ваш класс Service или Activity, вероятно, его необходимо будет прописать в шаблоне манифеста - AndroidManifest.template.xml. Такой шаблон можно найти в папке любого проекта на Delphi XE с target-platform = Android.
  6. Модифицированный classes.dex необходимо подключить к проекту в меню Project -> Deployment на подобие того, как это сделано с оригинальным classes.dex. Оригинальный classes.dex при этом следует отключить.

При первом использовании рекомендуется заглянуть в build.bat и определить переменные ANDROID и EMBO_DEX в соответствии со своим рабочим окружением.

  • ANDROID - Путь к ANDROID SDK (рекомендуется использовать SDK, распространяющийся вместе с Delphi XE);
  • EMBO_DEX - Путь к classes.dex от Embarcadero (не нужен, если присутствует classes.dex в папке lib этого набора).
  • PROJ_DIR - Рабочая директория (т.е. папка, из которой запущен скрипт).

Добавление библиотеки (jar)

(актуально для Delphi XE5/XE6)

  1. Разместить библиотеку в папке lib, переименовать в sdk.jar (либо исправить имя в 27 строке файла merge_jar_dex.bat);
  2. Разместить classes.dex в папке lib.
    Если во время исполнения скрипта файл classes.dex не будет обнаружен в папке lib, будет использоваться classes.dex от Embarcadero (к нему необходимо указать путь - EMBO_DEX)
  3. Внести изменения в build.bat: указать путь к sdk, если он указан неверно.
  4. Запустить ./merge_jar_dex.bat из командной строки (находясь в папке compile, содержащей этот файл).
    Результатом слияния, если оно прошло успешно, будет output\dex\classes.dex.
  5. Модифицированный classes.dex необходимо подключить к проекту в меню Project -> Deployment на подобие того, как это сделано с оригинальным classes.dex. Оригинальный classes.dex при этом нужно отключить.

При первом использовании следует заглянуть в merge_jar_dex.bat и определить переменные ANDROID и EMBO_DEX в соответствии со своим рабочим окружением.

  • ANDROID - Путь к ANDROID SDK (рекомендуется использовать SDK, распространяющийся вместе с Delphi XE);
  • EMBO_DEX - Путь к classes.dex от Embarcadero (не нужен, если присутствует classes.dex в папке lib этого набора).
  • PROJ_DIR - Рабочая директория (т.е. папка, из которой запущен скрипт).

Начиная с версии XE7 работу с Java кодом значительно упростили, поэтому лучше следовать инструкции в этом блоге http://delphifmandroid.blogspot.com.by/2015/03/jar.html

Распространённые ошибки

  1. 'java' is not recognized as an internal or external command
    java не найдена.
    Решение: настроить переменные окружения (JAVA_HOME и PATH). JAVA_HOME содержит путь к java, а в PATH нужно добавить %JAVA_HOME%\bin

  2. Dx bad class file magic (cafebabe) or version ...
    Может возникать при сочетании dx.jar из Delphi XE5 (Android 4.2) и Java 7. (Текущая версия Java выводится в начале работы скрипта)
    Решение: использовать Java 6.

  3. Чёрный экран при запуске приложения.
    Внутри apk находится более одного classes.dex.
    Решение: лишние classes.dex нужно отключать/удалять в меню Project -> Deployment.

Лицензия

Скрипты написаны для личного использования, распространяются "как есть", никакой ответственности за последствия их использования я не несу. Разрешается использовать и изменять по своему усмотрению.

Credits

  1. Автор оригинального скрипта build.bat: Brian Long aka blong (http://blong.com/Articles/DelphiXE5AndroidActivityResult/ActivityResult.htm)
  2. Автор dex2jar: Bob Pan aka pxb1988 (https://sourceforge.net/projects/dex2jar/)
  3. Инструкция и изменения в скрипте: Pavel Homal aka naXa!

About

Набор скриптов для упрощения жизни Android разработчикам в Delphi XE5 и XE6

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published