Zainstaluj przekaźnik

Przekaźnik składa się z 3 części, z których każdą należy zainstalować oddzielnie:

1. Przekaźnik dla wtyczki Figma
2. Przekaźnik dla wtyczki Android Studio
3. 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.

Uwaga: ta dokumentacja została opracowana na podstawie Flamingo i wtyczki Android Gradle w wersji 8.0. Szczegóły mogą się nieznacznie różnić w kolejnych wersjach.

Uwaga: zakładamy, że masz licencję firmy Figma Professional lub Figma Organization. Niektóre z naszych funkcji korzystają z historii wersji i bibliotek zespołów, które mogą być niedostępne w licencji Starter.

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ę:

1. Na stronie internetowej firmy Figma otwórz stronę wtyczki Relay for Figma.

2. W prawym górnym rogu strony kliknij Wypróbuj.

   

3. 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.

   

4. 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ć:

Uwaga: jeśli używasz Android Studio po raz pierwszy i nie masz zainstalowanego pakietu SDK na Androida lub widzisz ekran powitalny z prośbą o skonfigurowanie pakietu SDK do Androida, wykonaj te czynności, aby skonfigurować pakiet SDK do Androida.

1. Otwórz Android Studio.
2. W menu głównym:
   • W przypadku systemu macOS wybierz Android Studio > Ustawienia.
   • W systemach Windows i Linux wybierz Plik > Ustawienia.
3. Wybierz Wtyczki.

4. Wybierz kartę Marketplace, wyszukaj „Relay for Android Studio” i wybierz wtyczkę opublikowaną przez Google:

   

5. Kliknij Zainstaluj.

6. Po zakończeniu instalacji kliknij Uruchom ponownie IDE.

7. 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()
    }
}

Uwaga: użyj najnowszej wersji wtyczki Relay Gradle, aby uzyskać dostęp do wszystkich najnowszych funkcji.

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:

1. Otwórz aplikację Figma i zaloguj się do niej.
2. Otwórz przeglądarkę plików .

3. Kliknij ikonę konta i wybierz Ustawienia.

   

4. Przewiń w dół do sekcji Osobiste tokeny dostępu.

5. Wpisz opis tokena, na przykład „Relay” (Przekaźnik) i wpisz Return. Zostanie wygenerowany token. Kliknij Kopiuj ten token.

   

6. W Android Studio wybierz z menu głównego Narzędzia > Ustawienia przekaźnika.

   

7. 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.

   

8. 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).

   

9. Kliknij OK.

Pobieranie i konfigurowanie wstępnie skonfigurowanego projektu

Uwaga: czynności opisane w tej sekcji są opcjonalne, ale zdecydowanie zalecane, jeśli chcesz korzystać z naszych samouczków. Jeśli zamiast korzystać ze wstępnie skonfigurowanego projektu, dowiedz się, jak ręcznie utworzyć projekt przekaźnika dla Android Studio.

Aby pobrać i skonfigurować wstępnie skonfigurowany projekt:

1. Pobierz plik ZIP projektu.
2. Kliknij dwukrotnie plik, aby go rozpakować. Spowoduje to utworzenie folderu o nazwie HelloFigma. Przenieś go do folderu głównego...
3. Wróć do Android Studio. Wybierz File > Open (Plik > Otwórz), przejdź do folderu głównego, wybierz HelloFigma i kliknij Open (Otwórz).
4. Gdy otworzysz projekt, Android Studio może zapytać, czy ufasz mu. Kliknij Trust Project.

Uwaga: ten wstępnie skonfigurowany projekt wymaga wtyczki Android Studio Flamingo lub nowszej i wtyczki Androida do obsługi Gradle w wersji 8.0. Zakładamy też, że zostanie użyty element Utwórz materiał. Jeśli chcesz użyć narzędzia Compose Material 3, wykonaj instrukcje podane tutaj, aby dodać do projektu odpowiednie zależności.

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.

Samouczek podstawowy