Przekaźnik składa się z 3 części, z których każdą należy zainstalować oddzielnie:
- Przekaźnik dla wtyczki Figma
- Przekaźnik dla wtyczki Android Studio
- Wtyczka przekazywania Gradle
Wymagania wstępne
- Musisz zalogować się na konto Figma.
- masz zainstalowane Android Studio w wersji 2022.2.1 Flamingo lub nowszej,
- Zainstalowano środowisko wykonawcze Java.
- Używasz Jetpack Compose w wersji 1.2 lub nowszej.
- Używasz wtyczki Gradle w wersji 8.0 lub nowszej.
Instalowanie wtyczki Relay for Figma
Dzięki wtyczce Relay for Figma każdy użytkownik Figma może dodawać adnotacje do swoich projektów i udostępniać je deweloperom, którzy korzystają z Android Studio i Jetpack Compose.
Wtyczka Relay for Figma została opublikowana na platformie handlowej Figma. Aby zainstalować wtyczkę:
- Na stronie internetowej firmy Figma otwórz stronę wtyczki Relay for Figma.
W prawym górnym rogu strony kliknij Wypróbuj.
Może pojawić się okno z pytaniem, czy chcesz korzystać z wtyczki. W oknie wybierz swoją organizację. W rzadkich przypadkach organizacja może wyłączyć publiczne wtyczki. Jeśli tak, wybierz opcję Zespoły zewnętrzne.
Otworzy się plik Figma ze stroną z informacjami o wtyczce. Kliknij ... i wybierz Zapisz, aby móc łatwo ponownie użyć wtyczki.
Teraz kliknij Uruchom:
Uruchomioną wtyczkę możesz wyświetlić w obszarze roboczym Figma:
Instalowanie wtyczki Relay for Android Studio
Wtyczka Relay for Android Studio umożliwia programistom pracującym w Android Studio importowanie projektów, do których dodano adnotacje z informacjami o intencji projektowej za pomocą wtyczki Relay for Figma. Wtyczka została opublikowana w Android Studio Plugin Marketplace. Aby zainstalować:
- Otwórz Android Studio.
- W menu głównym:
- W przypadku systemu macOS wybierz Android Studio > Ustawienia.
- W systemach Windows i Linux wybierz Plik > Ustawienia.
- Wybierz Wtyczki.
Wybierz kartę Marketplace, wyszukaj „Relay for Android Studio” i wybierz wtyczkę opublikowaną przez Google:
Kliknij Zainstaluj.
Po zakończeniu instalacji kliknij Uruchom ponownie IDE.
Aby sprawdzić, czy instalacja się powiodła, otwórz Preferencje lub Ustawienia, a następnie kliknij Wtyczki. W sekcji Zainstalowane powinno być widoczne Przekaźnik dla Android Studio.
Instalowanie wtyczki Relay Gradle
Wtyczka Relay Gradle zapewnia, że projekty w Figmie z adnotacjami o intencjach projektowych za pomocą wtyczki Relay for Figma są prawidłowo przekonwertowane na kod podczas kompilacji.
Wtyczka Relay Gradle jest publikowana w Google Maven, czyli serwerze zawierającym wiele wtyczek Gradle. Android Studio domyślnie wywołuje operacje Gradle. Obejmuje to pobieranie i instalowanie zależności, do których odwołuje się Twój projekt.
Aby mieć pewność, że Android Studio, a w rezultacie sama Gradle, pobierze i zainstaluje wtyczkę Relay Gradle, musisz określić ją jako zależność w projekcie, a zwłaszcza w pliku build.gradle
w katalogu modułu. Zwykle jest w: app/build.gradle
.
U góry pliku app/build.gradle
znajduje się sekcja z listą wszystkich używanych wtyczek. Dodaj do tej listy wtyczkę Relay Gradle, a Gradle zajmie się jej pobieraniem i instalowaniem. Na przykład:
plugins {
id 'com.android.application'
id 'kotlin-android'
id 'com.google.relay' version '0.3.12'
}
Upewnij się też, że plik settings.gradle
zawiera tę sekcję:
pluginManagement {
repositories {
gradlePluginPortal()
google()
mavenCentral()
}
}
Możesz też użyć wstępnie skonfigurowanego projektu, który obejmuje podaną powyżej konfigurację.
Skonfiguruj dostęp do Figma
Usługa Relay wymaga osobistego tokena dostępu Figma, by mogła pobrać Twoje projekty Figma i przekonwertować je na kod. Jeśli jeszcze nie masz konta:
- Otwórz aplikację Figma i zaloguj się do niej.
- Otwórz przeglądarkę plików .
Kliknij ikonę konta i wybierz Ustawienia.
Przewiń w dół do sekcji Osobiste tokeny dostępu.
Wpisz opis tokena, na przykład „Relay” (Przekaźnik) i wpisz Return. Zostanie wygenerowany token. Kliknij Kopiuj ten token.
W Android Studio wybierz z menu głównego Narzędzia > Ustawienia przekaźnika.
Jeśli masz już skonfigurowany token dostępu aplikacji Figma w systemie macOS, możesz zobaczyć to okno. To okno informuje, że Android Studio używa dotychczasowego tokena dostępu aplikacji Figma. Wpisz hasło i kliknij Zawsze zezwalaj.
Wklej token dostępu aplikacji Figma w polu Token dostępu Figma. (Jeśli nie konfigurujesz tokenu dostępu aplikacji Figma po raz pierwszy, możesz zobaczyć komunikat Istniejący token dostępu aplikacji Figma).
Kliknij OK.
Pobieranie i konfigurowanie wstępnie skonfigurowanego projektu
Aby pobrać i skonfigurować wstępnie skonfigurowany projekt:
- Pobierz plik ZIP projektu.
- Kliknij dwukrotnie plik, aby go rozpakować. Spowoduje to utworzenie folderu o nazwie HelloFigma. Przenieś go do folderu głównego...
- Wróć do Android Studio. Wybierz File > Open (Plik > Otwórz), przejdź do folderu głównego, wybierz HelloFigma i kliknij Open (Otwórz).
- Gdy otworzysz projekt, Android Studio może zapytać, czy ufasz mu. Kliknij Trust Project.
Uruchamianie wstępnie skonfigurowanego projektu
Uruchom aplikację w emulatorze lub na urządzeniu. Na pustym ekranie powinna się pojawić wiadomość „Hello, Android!”.
Następny krok
Teraz możemy utworzyć pierwsze projekty w usłudze Relay.
Polecane dla Ciebie
- Uwaga: tekst linku jest wyświetlany, gdy JavaScript jest wyłączony
- Konfigurowanie projektu na Androida
- Testowanie układu tworzenia wiadomości
- Gdzie przenieść stan