Dodawanie modułu dla nowego urządzenia

Moduły to kontener na kod źródłowy aplikacji, pliki zasobów i ustawienia na poziomie aplikacji, np. plik kompilacji na poziomie modułu i plik manifestu Androida. Każdy moduł można niezależnie tworzyć, testować i debugować.

Android Studio wykorzystuje moduły ułatwiające dodawanie nowych urządzeń do projektu. Wykonując kilka prostych czynności w Android Studio, możesz utworzyć moduł z kodem dostosowanym do typu urządzenia, np. Wear OS lub Androida TV. Android Studio automatycznie tworzy katalogi modułów, takie jak katalogi źródeł i zasobów, oraz domyślny plik build.gradle odpowiedni dla typu urządzenia. Android Studio tworzy też moduły urządzeń z zalecanymi konfiguracjami kompilacji, np. korzysta z biblioteki TalkBack dla modułów Androida TV.

Na tej stronie opisujemy, jak dodać nowy moduł dla określonego urządzenia.

Android Studio ułatwia też dodawanie biblioteki lub modułu Google Cloud do projektu. Szczegółowe informacje o tworzeniu modułu biblioteki znajdziesz w artykule o tworzeniu modułu biblioteki.

Tworzenie nowego modułu

Aby dodać do projektu nowy moduł dla nowego urządzenia, wykonaj te czynności:

  1. Kliknij File (Plik) > New (Nowy) > New Module (Nowy moduł).
  2. W wyświetlonym oknie Utwórz nowy moduł Android Studio zawiera te moduły urządzeń:
    • Moduł telefonu i tabletu
    • Moduł Wear OS
    • Moduł Android TV
    • Moduł szklany
    Wybierz moduł dla wybranego urządzenia i kliknij Dalej.
  3. W formularzu Skonfiguruj nowy moduł wpisz te informacje:
    • Nazwa aplikacji: ta nazwa będzie używana jako tytuł ikony programu uruchamiającego aplikacje dla nowego modułu.
    • Nazwa modułu: ten tekst jest używany jako nazwa folderu, w którym widoczne są pliki kodu źródłowego i plików zasobów.
    • Nazwa pakietu: jest to przestrzeń nazw Javy dla kodu w Twoim module. Jest on dodawany jako atrybut package w pliku manifestu Androida modułu.
    • Minimalny pakiet SDK: to ustawienie wskazuje najniższą wersję platformy Androida obsługiwaną przez moduł aplikacji. Ta wartość ustawia w pliku build.gradle atrybut minSdkVersion, który możesz później edytować.

    Następnie kliknij Dalej.

  4. W zależności od wybranego modułu urządzenia na następnej stronie pojawią się odpowiednie szablony kodu, których możesz użyć jako głównego działania. Kliknij szablon aktywności, od którego chcesz zacząć, a potem kliknij Dalej. Jeśli nie potrzebujesz żadnej aktywności, kliknij kolejno Dodaj brak aktywności i Zakończ.
  5. Jeśli wybierzesz szablon aktywności, podaj jego ustawienia na stronie Dostosuj aktywność. Większość szablonów wymaga podania nazwy działania, nazwy układu, tytułu i języka źródłowego, ale każdy szablon ma ustawienia związane z daną aktywnością. Kliknij Zakończ. Po utworzeniu modułu aplikacji z szablonem aktywności możesz go natychmiast uruchomić i przetestować na swoim urządzeniu.

Android Studio utworzy wszystkie pliki potrzebne dla nowego modułu i zsynchronizuje projekt z plikami Gradle nowego modułu. Dodanie modułu dla nowego urządzenia powoduje też dodanie wszystkich wymaganych zależności urządzenia docelowego do pliku kompilacji modułu.

Po zakończeniu synchronizacji projektu Gradle nowy moduł pojawi się w oknie Projekt po lewej stronie. Jeśli nie widzisz folderu nowego modułu, sprawdź, czy w oknie wyświetla się widok Androida.

Importowanie modułu

Aby zaimportować do projektu istniejący moduł, wykonaj te czynności:

  1. Kliknij Plik > Nowy > Importuj moduł.
  2. W polu Katalog źródłowy wpisz lub wybierz katalog modułów, które chcesz zaimportować:
    • Jeśli importujesz jeden moduł, podaj jego katalog główny.
    • Jeśli importujesz wiele modułów z projektu, wskaż folder projektu. Dla każdego modułu w folderze pojawi się pole z danymi Lokalizacja źródłowa oraz Nazwa modułu. Sprawdź, czy przy każdym module, który chcesz zaimportować, zaznaczone jest pole Importuj.
    Jeśli Twoje moduły mają inne zależności, znajdziesz je na liście do zaimportowania w sekcji Dodatkowe wymagane moduły.
  3. Wpisz odpowiednie nazwy modułów w polach Nazwa modułu.
  4. Kliknij Zakończ.

Po zaimportowaniu modułu pojawi się on w oknie projektu po lewej stronie.

Dalsze kroki

Po dodaniu nowego modułu możesz zmodyfikować jego kod i zasoby, skonfigurować ustawienia kompilowania modułów i utworzyć moduł. Możesz go uruchomić i debugować jak każdą inną aplikację.

Przydatny będzie też kod i zasoby, które pozwolą na prawidłową obsługę nowego urządzenia. Więcej informacji o tworzeniu modułów aplikacji na różne typy urządzeń znajdziesz w odpowiedniej dokumentacji:

Przy tworzeniu nowego modułu możesz utworzyć kod niezależny od urządzenia, który jest już zduplikowany w innym module aplikacji. Zamiast duplikować kod, rozważ przeniesienie udostępnionego kodu do modułu biblioteki i dodanie tej biblioteki jako zależności do modułów aplikacji. Więcej informacji o tworzeniu modułu biblioteki i dodawaniu go jako zależności znajdziesz w artykule Tworzenie biblioteki na Androida.