HMS Toolkit Convertor

HMS Toolkit Convertor — это инструмент для преобразования кода, который поддерживает проекты на Java и Kotlin. Он помогает разработчикам автоматически преобразовывать API-интерфейсы GMS, вызываемые приложениями, в соответствующие API-интерфейсы HMS. Это обеспечивает быструю интеграцию с HMS.

Основные функции HMS Convertor:

• Новое преобразование: автоматическое преобразование API-интерфейсов GMS, используемых приложением, в API-интерфейсы HMS;
• Открыть последнее преобразование: открытие последнего результата преобразования;
• Сохранить всё: сохранение текущего проекта и информации о преобразовании;
• Восстановить проект: восстановление проекта из файла резервной копии.

Сборка

Для работы с Convertor требуются Gradle версии 5.2.1 или выше и JDK версии 8 или выше. Чтобы загрузить код, выполните команду git clone, перейдите в каталог Convertor/src и выполните следующую команду:

$ ./gradlew -p IDE/intellij-plugin buildPlugin

После завершения сборки перейдите в каталог Convertor/src/IDE/intellij-plugin/build/distributions, чтобы просмотреть пакет плагина в формате .zip.

Установка

Запустите IDEA или Android Studio и выберите меню File -> Settings -> Plugins -> Install Plugin from Disk. Выберите ZIP-пакет плагина, созданный во время сборки.

Вы можете отладить плагин в песочнице с помощью следующей команды:

$ ./gradlew -p IDE/intellij-plugin runIde

Дополнительные сведения см. в Руководстве по использованию.

Запуск и отладка в среде IDE

1. Клонируйте репозиторий с помощью команды git clone.
2. Если вы используете IntelliJ, откройте папку src внутри проекта через меню File > Open.
3. Откройте файл build.gradle, найдите свойство alternativeIdePath, раскомментируйте его и установите путь установки IntelliJ IDE, в которой будет запущен плагин (в данном случае Android Studio).
4. В окне инструментов Gradle нажмите на значок «Перезагрузить все проекты Gradle».
5. Теперь вы можете запустить проект, выбрав Run > Run (запускает экземпляр с установленным плагином) или Run > Debug (режим отладки).

Вклад в код

Чтобы внести вклад в проект Convertor, выполните следующие шаги:

1. Форк репозитория на GitHub.
2. Клонируйте проект на свой компьютер.
3. Внесите изменения в свою собственную ветку.
4. Отправьте свою работу обратно в свой форк.
5. Отправьте запрос на вытягивание, чтобы мы могли рассмотреть ваши изменения.

Перед отправкой запроса на вытягивание обязательно объедините последние изменения из «восходящего потока»!

Вопросы или проблемы

Если вы хотите узнать больше об HMS Core, r/HMSCore на Reddit — это место, где можно быть в курсе последних новостей об HMS Core и обмениваться идеями с другими разработчиками. Вопросы об использовании примеров HMS:

• Попробуйте следующие варианты:
  • Stack Overflow — лучшее место для любых вопросов по программированию. Не забудьте добавить тег huawei-mobile-services.
  • Форум разработчиков Huawei (Huawei Developer Forum) — отличный вариант, если у вас есть общие вопросы или вам нужны рекомендации и мнения. Раздел — HMS Core Module.

Если вы столкнулись с ошибкой в наших примерах, отправьте сообщение о проблеме (issue) в репозиторий. Ещё лучше — отправьте запрос на перенос изменений (pull request) с исправлением.

Лицензия

HMS Toolkit Convertor лицензируется согласно версии 2.0 Apache License.