Konfigurowanie dostarczania podczas instalacji

Moduły funkcji pozwalają oddzielić niektóre funkcje i zasoby z modułu podstawowego aplikacji i uwzględnij je w pakiecie aplikacji. Dostępne opcje Następnie dostosuj opcje dostawy. aby kontrolować, kiedy i jak urządzenia z Androidem 5.0 (poziom interfejsu API 21) lub nowszym pobrać funkcje aplikacji.

Pamiętaj, że ten typ modularyzacji wymaga większego wysiłku, a potencjalnie do refaktoryzacji istniejącego kodu aplikacji, więc dobrze się zastanów, który określonych funkcji aplikacji najlepiej byłoby, gdyby były dostępne dla użytkowników na żądanie.

Jeśli chcesz stopniowo dzielić funkcje aplikacji na moduły w miarę upływu czasu, bez zmianę działania aplikacji lub dostosowanie zaawansowanych opcji dostarczania, można to zrobić, tworząc moduły funkcji skonfigurowane pod kątem czasu instalacji . Oznacza to, że możesz modułowo skonfigurować funkcję jako moduł cech, ale nie włącz opcje zaawansowane, aby ta funkcja była dostępna, gdy użytkownik zainstaluje Twoją .

Dodatkowo moduły funkcji skonfigurowane pod kątem dostarczania w czasie instalacji można później odinstalować, jeśli nie są już potrzebne. Aby to zrobić, musisz je skonfigurować jako zdejmowane.

Ta sekcja zawiera informacje o tym, jak utworzyć moduł funkcji na potrzeby czasu instalacji . Zanim zaczniesz, upewnij się, używasz Android Studio 3.5 lub nowszego i wtyczki Androida do obsługi Gradle w wersji 3.5.0. lub wyższą.

Skonfiguruj nowy moduł na potrzeby dostarczania podczas instalacji

Najłatwiejszym sposobem utworzenia nowego modułu funkcji jest użycie Android Studio 3.5 lub nowszy, Ponieważ moduły funkcji mają jest uzależniona od podstawowego modułu aplikacji, można go dodać tylko do istniejącego projekty aplikacji.

Aby dodać moduł funkcji do projektu aplikacji za pomocą Android Studio: wykonaj następujące czynności:

  1. Otwórz projekt aplikacji w IDE.
  2. Wybierz Plik > Nowe > Nowy moduł na pasku menu.
  3. W oknie Create New Module (Utwórz nowy moduł) wybierz Dynamic Feature Module (Moduł funkcji dynamicznych) i kliknij Next (Dalej).
  4. W sekcji Skonfiguruj nowy moduł wykonaj :
    1. Wybierz Podstawowy moduł aplikacji na potrzeby projektu aplikacji menu.
    2. Wypełnij pole Nazwa modułu. IDE używa tej nazwy do zidentyfikowania jako podprojektu Gradle w Plik ustawień Gradle. Gdy aby utworzyć pakiet aplikacji, Gradle używa ostatniego elementu podprojektu nazwa w celu wstawienia atrybutu <manifest split> w plik manifestu modułu funkcji.
    3. Podaj nazwę pakietu modułu. Domyślnie Android Studio sugeruje nazwę pakietu, która łączy nazwę pakietu głównego modułu podstawowego i nazwy modułu określonej w poprzednim kroku.
    4. Wybierz Minimalny poziom interfejsu API, który ma być obsługiwany przez moduł. Ta wartość powinna być zgodna z wartością modułu podstawowego.
  5. Kliknij Dalej.

  6. W sekcji Opcje pobierania modułu wykonaj te czynności:

    1. Określ Tytuł modułu za pomocą maksymalnie 50 znaków. Baza aplikacji moduł musi zawierać tytuł modułu jako string resource, co potrafi tłumaczyć. Przy tworzeniu modułu w Android Studio IDE doda zasób łańcuchowy do modułu podstawowego i wstrzykuje makro następujący wpis w pliku manifestu modułu funkcji:

      <dist:module
    ...
    dist:title="@string/feature_title">
</dist:module>

    2. W menu w sekcji Uwzględnienie podczas instalacji wybierz Uwzględnij. podczas instalacji. Android Studio wstawia w z pliku manifestu modułu.

      <dist:module ... >
  <dist:delivery>
      <dist:install-time />
  </dist:delivery>
</dist:module>

      Jeśli chcesz się dowiedzieć, jak utworzyć moduł funkcji które można pobrać po zainstalowaniu aplikacji, przeczytaj skonfigurować dostarczanie na żądanie.

    3. Zaznacz pole Fusing, aby ten moduł był dostępny. na urządzeniach z Androidem 4.4 (poziom interfejsu API 20) lub starszym z wieloma plikami APK. Oznacza to, że możesz ją pominąć na urządzeniach, które nie obsługują pobieranie i instalowanie dzielonych pakietów APK. Android Studio wstawia zgodnie z Twoim wyborem w pliku manifestu modułu:

      <dist:module ...>
    <dist:fusing dist:include="true | false" />
</dist:module>

  7. Kliknij Zakończ.

Gdy Android Studio zakończy tworzenie modułu, sprawdź jego zawartość w panelu Projekt (wybierz Widok > Okna narzędziowe > Projekt) na pasku menu). Domyślnym kodem, zasobami i organizacją powinny być jak w standardowym module aplikacji.

Usuwanie modułu podczas instalacji

Warto utworzyć moduły funkcji na potrzeby dostarczania w czasie instalacji, które można później odinstalować, jeśli nie są już potrzebne. Aby na przykład zmniejszyć rozmiar w swojej aplikacji możesz modułowo połączyć treści potrzebne podczas szkolenia lub wprowadzenia, a potem odinstalować moduł funkcji za pomocą interfejsu Play Core API. gdy użytkownik skończy korzystać z Twojej aplikacji.

Moduły podczas instalacji nie są domyślnie wyjmowane. Aby oznaczyć moduł jako możliwy do odinstalowania, dodaj tag removable i ustaw jego wartość na true:

<dist:module ... >
  <dist:delivery>
      <dist:install-time>
          <dist:removable dist:value="true"/>
      </dist:install-time>
  </dist:delivery>
</dist:module>