Share via

Tworzenie aplikacji Java dla systemu Android

  • Artykuł

Ważne

Program Visual Studio App Center ma zostać wycofany 31 marca 2025 r. Chociaż możesz nadal używać programu Visual Studio App Center do momentu jego pełnego wycofania, istnieje kilka zalecanych alternatyw, do których można rozważyć migrację.

Dowiedz się więcej o osiach czasu pomocy technicznej i alternatywach.

Aby utworzyć pierwszą aplikację dla systemu Android, wykonaj następujące kroki:

  1. Połącz się z kontem usługi repozytorium (GitHub, Bitbucket, VSTS, Azure DevOps).
  2. Wybierz repozytorium i gałąź, w której znajduje się aplikacja.
  3. Wybierz projekt systemu Android, który chcesz skompilować.
  4. Skonfiguruj pierwszą kompilację.

Uwaga

Aby aplikacja została uruchomiona na rzeczywistym urządzeniu, kompilacja musi być podpisana przy użyciu prawidłowego certyfikatu.

Uwaga

Centrum aplikacji śledzi projekt, wyszukując pliki katalogów narzędzia gradle (i gradlew) projektu systemu Android. Nie dołączaj tych plików do pliku .gitignore projektu, ponieważ kompilacja centrum aplikacji nie będzie mogła ich odnaleźć.

Ostrzeżenie

Ze względu na niedawne zamknięcie programu JCenter niektóre aplikacje mogą napotkać błędy zadań narzędzia Gradle podczas kompilowania przy użyciu centrum aplikacji. Zapoznaj się z przewodnikiem migracji dostarczonym przez narzędzie Gradle. Aby obejść ten problem, wszystkie wystąpienia jcenter() programu można usunąć z build.gradle pliku i zastąpić ciąg .jcenter { url "http://jcenter.bintray.com/"} Dowiedz się więcej o zamykaniu centrum JCenter tutaj.

1. Łączenie repozytorium

Jeśli jeszcze tego nie zrobiono, musisz nawiązać połączenie z kontem usługi repozytorium. Po nawiązaniu połączenia z kontem wybierz repozytorium, w którym znajduje się projekt systemu Android. Aby skonfigurować kompilację dla repozytorium, musisz mieć uprawnienia administratora i ściągania.

2. Wybieranie gałęzi

Po wybraniu repozytorium wybierz gałąź, którą chcesz skompilować. Domyślnie zostaną wyświetlone wszystkie aktywne gałęzie.

3. Konfigurowanie pierwszej kompilacji

Przed pierwszą kompilacją należy skonfigurować projekt systemu Android.

3.1. Wyzwalacze kompilacji

Domyślnie nowa kompilacja jest wyzwalana za każdym razem, gdy deweloper wypycha do skonfigurowanej gałęzi. Jest to nazywane "ciągłą integracją". Jeśli wolisz ręcznie wyzwolić nową kompilację, możesz zmienić to ustawienie w okienku konfiguracji.

3.2. Wariant kompilacji

Dostępne warianty kompilacji zostaną wypełnione na podstawie typów kompilacji i smaków produktów określonych w pliku build.gradle (poziom aplikacji). Wybierz wariant kompilacji, który ma zostać skompilowany.

Uwaga

Kompilacja usługi App Center obsługuje znajdowanie wariantów kompilacji jako kombinacji typu kompilacji (debugowania, wydania lub niestandardowego zdefiniowanego) i jednego z zadeklarowanych produktów w narzędziu gradle. Wykrywanie wymiarów smaków (kombinacji wielu odmian produktów) nie jest obecnie obsługiwane.

3.3. Tworzenie pakietu aplikacji systemu Android (aab)

Pakiet aplikacji systemu Android jest formatem dystrybucji przekazywanym do Sklepu Play i używanym do generowania zoptymalizowanych zestawów API dla określonych urządzeń. Więcej informacji na temat pakietu aplikacji systemu Android można znaleźć w oficjalnej dokumentacji systemu Android.

Przełącz opcję pakietu aplikacji dla systemu Android, aby utworzyć .aab element oprócz elementu .apk. build.gradle Jeśli plik (poziom aplikacji) zawiera android.bundle blok, ta opcja będzie już włączona.

3.4. Numer wersji przyrostowej

Po włączeniu kod wersji w AndroidManifest.xml aplikacji automatycznie zwiększa się dla każdej kompilacji. Zmiana odbywa się podczas rzeczywistej kompilacji i nie zostanie zatwierdzona w repozytorium.

3.5. Podpisywanie kodu

Pomyślna kompilacja spowoduje utworzenie .apk pliku i dodatkowego .aab pliku, jeśli zostanie włączone. Aby wydać kompilację do Sklepu Play, należy ją podpisać przy użyciu ważnego certyfikatu przechowywanego w magazynie kluczy. Aby podpisać kompilacje utworzone z gałęzi, włącz podpisywanie kodu w okienku konfiguracji, przekaż magazyn kluczy do repozytorium i podaj odpowiednie poświadczenia w okienku konfiguracji. Więcej informacji na temat logowania kodu można dowiedzieć się w dokumentacji podpisywania kodu w usłudze App Center dla systemu Android. Zostanie .aab podpisany przy użyciu tych samych poświadczeń co ..apk

3.6. Uruchamianie pomyślnej kompilacji na rzeczywistym urządzeniu

Użyj nowo utworzonego pliku APK, aby sprawdzić, czy aplikacja zostanie uruchomiona na rzeczywistym urządzeniu. Spowoduje to dodanie około 10 minut do łącznego czasu kompilacji. Przeczytaj więcej na temat konfigurowania testów uruchamiania.

3.7. Konfigurowanie z pliku build.gradle (poziom aplikacji)

Określone informacje o kompilacji będą zbierane z pliku narzędzia Gradle, w tym zależności, wersji narzędzi kompilacji, typów kompilacji i odmian produktów.

3.8. Dystrybuowanie kompilacji

Można skonfigurować każdą pomyślną kompilację z gałęzi, która ma być dystrybuowana do wcześniej utworzonej grupy dystrybucyjnej lub miejsca docelowego magazynu. Możesz dodać nową grupę dystrybucyjną lub skonfigurować połączenie magazynu z poziomu usługi rozproszonej. Zawsze istnieje domyślna grupa dystrybucyjna o nazwie "Współpracownicy", która obejmuje wszystkich użytkowników, którzy mają dostęp do aplikacji.

Uwaga

W przypadku dystrybucji do sklepu Google Play preferowany jest pakiet aplikacji systemu Android (.aab) i będzie dystrybuowany, jeśli jest włączony. W przypadku grup dystrybucyjnych usługi App Center i Intune miejscach docelowych sklepu regularne .apk będą używane nawet wtedy, gdy .aab element jest również generowany.

4. Wyniki kompilacji

Po wyzwoleniu kompilacji może ona znajdować się w następujących stanach:

  • queued — kompilacja znajduje się w kolejce oczekującej na zwolnienie zasobów.
  • kompilowanie — aplikacja kompiluje i uruchamia powiązane zadania.
  • powodzenie — kompilacja została ukończona pomyślnie.
  • failed — kompilacja została ukończona, ale nie powiodła się. Możesz pobrać i sprawdzić dziennik kompilacji na potrzeby rozwiązywania problemów.
  • anulowano — kompilacja została anulowana przez akcję użytkownika lub upłynął limit czasu.

4.1. Dzienniki kompilacji

W przypadku ukończonej kompilacji (zakończonej powodzeniem lub niepowodzeniem) pobierz dzienniki, aby dowiedzieć się więcej na temat sposobu działania kompilacji. Usługa App Center udostępnia archiwum z następującymi plikami:

|-- 1_build.txt (this is the general build log)
|-- build (this folder contains a separate log file for each build step)
    |-- <build-step-1>
    |-- <build-step-2>
    |--
    |-- <build-step-n> (e.g. n_Post Job Cleanup.txt)

Dzienniki specyficzne dla kroku kompilacji (znajdujące się w katalogu kompilacji/archiwum) są przydatne do rozwiązywania problemów i zrozumienia, w jakim kroku i dlaczego kompilacja nie powiodła się.

4.2. Pakiet aplikacji (APK)

Pakiet APK to pakiet zawierający aplikację i zasoby systemu Android. Jeśli kompilacja jest poprawnie podpisana, plik APK można zainstalować na rzeczywistym urządzeniu i wdrożyć w Sklepie Play. Jeśli kompilacja nie została podpisana, plik APK można uruchomić na emulatorze lub użyć go do innych celów.

4.3. Kompilowanie wielu zestawów API

Jeśli konfiguracja aplikacji kompiluje wiele interfejsów API, musisz również utworzyć uniwersalny pakiet APK. Nasz system kompilacji działa z jednym głównym plikiem APK i zignoruje wszystkie interfejsy API specyficzne dla określonego procesora CPU ABI lub gęstości ekranu. Aby dowiedzieć się więcej o podziałach apk i tworzeniu uniwersalnego zestawu APK, przeczytaj przewodnik podziału ABI.

4.4. Plik mapowania deobfuscation (mapping.txt)

Plik mapping.txt zawiera informacje na temat mapowania zaciemnionych śladów stosu dla aplikacji z powrotem do oryginalnych nazw klas i metod.

  • Jeśli wcześniej zintegrowano zestaw SDK centrum aplikacji w aplikacji z włączonym modułem raportowania awarii i użyj narzędzia Proguard lub R8, aby zminimalizować i zaciemniać dane binarne aplikacji, usługa raportowania awarii wymaga tego mapping.txt pliku dla kompilacji w celu wyświetlenia raportów awarii możliwych do odczytania przez człowieka (deobfuscated).
  • Jeśli wcześniej zintegrowano inny zestaw SDK na potrzeby raportowania awarii w aplikacji (na przykład zestaw SDK usługi HockeyApp), odpowiednia usługa wymaga mapping.txt pliku do wyświetlania czytelnych raportów awarii.

5. Obsługiwane wersje i wymagania

Minimalna wersja obsługiwana do tworzenia aplikacji systemu Android to 7.0 (poziom 24 interfejsu API). Aplikacje systemu Android mogą mieć niższy minimalny poziom interfejsu API wymagany do uruchomienia, ale musi być przeznaczony dla co najmniej poziomu interfejsu API 24.

Aplikacje muszą być kompilowane przy użyciu narzędzia Gradle i wtyczki Android Gradle, aby można je było poprawnie skonfigurować. Repozytorium musi zawierać otokę narzędzia Gradle.

Zobacz również: Informacje o maszynie kompilacji w chmurze