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:
- Połącz się z kontem usługi repozytorium (GitHub, Bitbucket, VSTS, Azure DevOps).
- Wybierz repozytorium i gałąź, w której znajduje się aplikacja.
- Wybierz projekt systemu Android, który chcesz skompilować.
- 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.
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.
Po wybraniu repozytorium wybierz gałąź, którą chcesz skompilować. Domyślnie zostaną wyświetlone wszystkie aktywne gałęzie.
Przed pierwszą kompilacją należy skonfigurować projekt systemu Android.
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.
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.
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.
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.
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
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.
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.
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.
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ę.
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.
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.
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.
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