Реле состоит из трёх частей, каждая из которых устанавливается отдельно:
- Реле для плагина Figma
- Плагин Relay для Android Studio
- Плагин релейного Gradle
Предварительные условия
- Вы должны войти в учетную запись Figma .
- У вас установлена Android Studio 2022.2.1 Flamingo или более поздняя версия.
- Вы установили среду выполнения Java .
- Вы используете Jetpack Compose версии 1.2 или новее.
- Вы используете плагин Gradle версии 8.0 или новее.
Установите плагин Relay for Figma.
Плагин Relay for Figma позволяет любому, кто работает в Figma, комментировать свои проекты и делиться ими с разработчиками, использующими Android Studio и Jetpack Compose.
Плагин Relay for Figma опубликован на торговой площадке плагинов сообщества Figma. Чтобы установить плагин:
- Перейдите на страницу плагина Relay for Figma на веб-сайте Figma.
В правом верхнем углу страницы нажмите «Попробовать» .
Вы можете столкнуться с диалоговым окном с вопросом, хотите ли вы использовать плагин. В диалоговом окне выберите свою организацию. В редких случаях ваша организация может отключить общедоступные плагины. Если да, то выберите вариант «Внешние команды» .
Откроется файл Figma с отображенной страницей информации о плагине. Нажмите … и выберите «Сохранить» , чтобы можно было легко повторно использовать плагин.
Теперь нажмите «Выполнить» :
Вы можете просмотреть плагин, работающий на холсте Figma:
Установите плагин Relay для Android Studio.
Плагин Relay for Android Studio позволяет разработчикам, работающим в Android Studio, импортировать проекты, которые были аннотированы информацией о замысле дизайна, с помощью плагина Relay for Figma. Плагин опубликован на торговой площадке плагинов Android Studio. Чтобы установить:
- Откройте Android-студию.
- Из главного меню:
- Для macOS выберите Android Studio > «Настройки» .
- Для Windows и Linux выберите «Файл» > «Настройки» .
- Выберите Плагины .
Выберите вкладку «Marketplace», найдите «Relay for Android Studio» и выберите плагин, опубликованный Google:
Нажмите Установить .
По завершении установки нажмите «Перезапустить IDE» .
Чтобы убедиться, что установка прошла успешно, откройте «Настройки» или «Настройки» , затем перейдите в «Плагины» . Вы должны увидеть Relay for Android Studio, указанный в разделе «Установлено».
Установите плагин Relay Gradle.
Плагин Relay Gradle гарантирует, что проекты в Figma, аннотированные информацией о намерениях проекта с помощью плагина Relay for Figma, правильно преобразуются в код во время сборки.
Плагин Relay Gradle публикуется на Google Maven, сервере, содержащем множество плагинов Gradle. Android Studio по умолчанию вызывает операции Gradle, и эти операции включают загрузку и установку любых зависимостей, на которые ссылается ваш проект.
Чтобы гарантировать, что Android Studio и, как следствие, сам Gradle загрузит и установит плагин Relay Gradle, вам необходимо указать плагин в качестве зависимости в вашем проекте, в частности, в файле build.gradle
в каталоге вашего модуля. Обычно это app/build.gradle
.
В верхней части файла app/build.gradle
находится раздел со списком всех используемых плагинов. Добавьте плагин Relay Gradle в этот список, и Gradle выполнит его загрузку и установку. Например:
plugins {
id 'com.android.application'
id 'kotlin-android'
id 'com.google.relay' version '0.3.12'
}
Также убедитесь, что ваш файл settings.gradle
имеет следующий раздел:
pluginManagement {
repositories {
gradlePluginPortal()
google()
mavenCentral()
}
}
Вы также можете использовать предварительно настроенный проект , который включает конфигурацию, указанную выше.
Настройка доступа к Figma
Relay требуется токен личного доступа Figma , чтобы он мог загружать ваши проекты Figma и преобразовывать их в код. Если у вас его еще нет:
- Откройте Figma и войдите в Figma.
- Зайдите в файловый браузер.
Нажмите значок своей учетной записи и выберите «Настройки» .
Прокрутите вниз до раздела «Токены личного доступа» .
Введите описание токена, например «Реле», и введите Return. Токен генерируется. Нажмите «Копировать этот токен» .
В Android Studio в главном меню выберите «Инструменты» > «Настройки реле» .
Если вы ранее настроили токен доступа Figma в macOS, вы можете увидеть следующее диалоговое окно. В этом диалоговом окне вы узнаете, что Android Studio использует существующий токен доступа Figma. Введите свой пароль и нажмите «Всегда разрешать» .
Вставьте свой токен доступа Figma во входное поле «Токен доступа Figma» . (Если вы не впервые настраиваете токен доступа Figma, вы можете увидеть входные данные «Существующий токен доступа Figma» .)
Нажмите ОК .
Загрузите и настройте предварительно настроенный проект
Чтобы загрузить и настроить предварительно настроенный проект:
- Загрузите ZIP-файл проекта .
- Дважды щелкните файл, чтобы разархивировать его, при этом создается папка с именем HelloFigma . Переместите его в домашнюю папку..
- Вернитесь в Android Studio. Перейдите в «Файл» > «Открыть» , перейдите в свою домашнюю папку, выберите «HelloFigma» и нажмите «Открыть» .
- Когда вы открываете проект, Android Studio может спросить вас, доверяете ли вы этому проекту. Нажмите «Доверить проекту» .
Запуск предварительно настроенного проекта
Запустите приложение на эмуляторе или устройстве. Вы должны увидеть «Привет, Android!» на пустом экране.
Следующий шаг
Теперь мы готовы создавать наши первые проекты с помощью Relay.
{% дословно %}Рекомендуется для вас
- Примечание: текст ссылки отображается, когда JavaScript отключен.
- Настройте свой Android-проект
- Тестирование макета Compose
- Где поднять состояние