Tworzenie aplikacji Java dla systemu Android

Ważne

Program Visual Studio App Center ma zostać wycofany 31 marca 2025 r. Mimo że można 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 działała na rzeczywistym urządzeniu, kompilacja musi być podpisana kodem z prawidłowym certyfikatem.

Uwaga

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

Ostrzeżenie

Ze względu na niedawne zamknięcie centrum 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ągiem jcenter { url "http://jcenter.bintray.com/"}. Przeczytaj więcej na temat zamykania 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, potrzebujesz uprawnień administratora i ściągnięcia.

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 z plików Build Types and Product Flavors 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) oraz jednego z zadeklarowanych smaków produktów w programie Gradle. Wykrywanie wymiarów smaku (kombinacji wielu smaków produktów) nie jest obecnie obsługiwane.

3.3. Tworzenie pakietu aplikacji systemu Android (aab)

Pakiet aplikacji systemu Android to format dystrybucji przekazany do Sklepu Play i używany 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ć element .aab 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łączony. Aby wydać kompilację do Sklepu Play, należy ją podpisać przy użyciu prawidłowego 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 podpisywania kodu można uzyskać 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 smaków 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 miejsc docelowych sklepów usługi Intune regularne .apk będą używane nawet wtedy, gdy .aab element zostanie również wygenerowany.

4. Wyniki kompilacji

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

• queued — kompilacja znajduje się w kolejce czekającej na zwolnienie zasobów.
• kompilowanie — aplikacja kompiluje i uruchamia powiązane zadania.
• powodzenie — kompilacja została ukończona pomyślnie.
• niepowodzenie — 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/katalogu 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)

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

4.3. Kompilowanie wielu zestawów API

Jeśli konfiguracja aplikacji kompiluje wiele zestawów API, musisz też utworzyć uniwersalny pakiet APK. Nasz system kompilacji współpracuje z jednym głównym plikiem APK i zignoruje wszystkie apksy specyficzne dla określonego procesora CPU ABI lub gęstości ekranu. Aby dowiedzieć się więcej o podziałach apk i tworzeniu uniwersalnego pakietu 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 zaciemnić dane binarne aplikacji, usługa raportowania awarii wymaga tego mapping.txt pliku dla kompilacji w celu wyświetlenia raportów awarii czytelnych dla 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 , aby plik wyświetlał czytelne raporty o 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