Migracja projektów do Android Studio wymaga dostosowania się do nowego projektu struktury, systemu kompilacji i IDE.
Jeśli przeprowadzasz migrację z IntelliJ, a Twój projekt korzysta już z Gradle, możesz otworzyć istniejący projekt z Android Studio. Jeśli używasz IntelliJ, ale Twój projekt nie korzysta jeszcze z Gradle, musisz ręcznie przygotuj projekt przed zaimportowaniem go na Androida Studio. Więcej informacji znajdziesz w artykule Migracja z IntelliJ. .
Podstawy Android Studio
Oto kilka głównych różnic, o których należy pamiętać, przygotowując się do do Android Studio.
Organizacja projektu i modułów
Android Studio opiera się na modelu IntelliJ IDEA IDE. Aby się zapoznać z podstawami IDE, takimi jak nawigacja, uzupełnianie kodu i klawiatura zobacz Poznaj Android Studio.
Android Studio łączy kod w projekty zawierające wszystkie elementy, które definiują w aplikacji na Androida – od kodu źródłowego aplikacji po kompilowanie konfiguracji i testowanie kodu. Projekty otwierają się w oddzielnych oknach Android Studio. Każdy projekt zawiera co najmniej jeden moduł, który umożliwia podzielenie projektu na dyskretnych jednostek funkcjonalności. Moduły można niezależnie kompilować, testować zdebugowanymi.
Więcej informacji o Android Studio projektów i modułów znajdziesz w artykule Omówienie projektów.
System kompilacji oparty na Gradle
System kompilacji Android Studio opiera się Gradle i korzystanie z plików konfiguracji kompilacji napisane w języku Groovy lub Kotlin, aby można było łatwo rozszerzyć i personalizacji reklam.
Projekty oparte na Gradle oferują ważne funkcje w zakresie programowania na Androida, w tym:
- Obsługa bibliotek binarnych (AAR). Nie musisz już kopiować biblioteki do własnych projektów. możesz zadeklaruj zależność, a parametr biblioteka jest automatycznie pobierana i scalana z projektem. Ten obejmuje automatyczne scalanie zasobów, wpisów manifestu, ProGuard reguły wykluczania, niestandardowe reguły lintowania itp. w momencie kompilacji.
- obsługę wariantów kompilacji, które pozwalają tworzyć różne wersje aplikacji (np. wersji Pro i Pro) w tym samym projekcie.
- Łatwa konfiguracja kompilacji i łatwe dostosowywanie. Dla: możesz na przykład pobierać nazwy i kody wersji z tagów Git jako część budowania.
- Gradle można używać z IDE, z command line i ciągu z serwerami integracji, takimi jak Jenkins, zapewniając wszędzie tę samą kompilację obecnie się znajdujesz.
Więcej informacji o używaniu i konfigurowaniu Gradle znajdziesz w artykule Skonfiguruj kompilację.
Zależności
Zależności bibliotek w Android Studio używają deklaracji zależności Gradle i Zależności Maven dotyczące dobrze znanych lokalnych bibliotek źródłowych i bibliotek binarnych w Maven . Więcej informacji: Zadeklaruj zależności.
Migracja z IntelliJ
Jeśli Twój projekt IntelliJ używa systemu kompilacji Gradle, możesz importowanie projektu bezpośrednio do Android Studio. Jeśli Twój projekt IntelliJ używa Maven lub inny system kompilacji, musisz go skonfigurować do współpracy z Gradle przed migracją do Android Studio.
Zaimportuj projekt IntelliJ oparty na Gradle
Jeśli w swoim projekcie IntelliJ używasz już Gradle, otwórz go w w Android Studio, wykonując te czynności:
- Kliknij Plik > Nowe > Importuj projekt.
- Wybierz katalog projektu IntelliJ i kliknij OK. Twój projekt się otworzy w Android Studio.
Importowanie projektu innego niż Gradle IntelliJ
Jeśli Twój projekt IntelliJ nie korzysta jeszcze z systemu kompilacji Gradle, musisz do Androida Studio można wykorzystać dwie opcje, w następujących sekcjach:
- Utwórz nowy pusty projekt Android Studio i skopiuj istniejące źródło do katalogów powiązanych z nowym projektem. Więcej informacji można znaleźć w sekcji o przenoszeniu przez utworzenie nowej pustej kolumny projekt.
- Utwórz nowy plik kompilacji Gradle dla swojego projektu, a następnie zaimportuj projekt i nowy plik kompilacji w Android Studio. Więcej informacji: sekcji o przenoszeniu przez utworzenie niestandardowego pliku kompilacji Gradle.
Aby przeprowadzić migrację, utwórz nowy pusty projekt
Aby przenieść projekt do Android Studio przez utworzenie nowego pustego projektu, kopiując pliki źródłowe do nowych katalogów, wykonaj te czynności:
- Otwórz Android Studio i kliknij Plik > Nowe > Nowy projekt.
- Wpisz nazwę projektu aplikacji i określ lokalizację, w której kliknij Dalej.
- Wybierz formaty, na których działa Twoja aplikacja, i kliknij Dalej.
- Kliknij kolejno Dodaj brak aktywności i Zakończ.
- W oknie narzędzia Projekt kliknij strzałkę, aby otworzyć widok. i wybierz widok Projekt, aby wyświetlić organizacji nowego projektu w Android Studio. Aby dowiedzieć się więcej o zmianie oraz o tym, jak Android Studio tworzy projekty, znajdziesz w artykule Pliki projektów.
- Przejdź do lokalizacji wybranej dla nowego projektu i przenieś kod, testy jednostkowe, testy instrumentacji i zasoby ze starego projektu w odpowiednich lokalizacjach w strukturze nowego projektu.
- W Android Studio kliknij Plik > Struktura projektu, aby otworzyć Okno Struktura projektu. Upewnij się, że moduł aplikacji jest zaznaczony w w panelu po lewej stronie.
- Na karcie Właściwości wprowadź niezbędne zmiany w ustawieniach tagu
(np. zmodyfikowanie
minSdk
lubtargetSdk
). - Kliknij Zależności i dodaj wszystkie biblioteki, od których zależy Twój projekt
jako zależności Gradle. Aby dodać nową zależność, kliknij Dodaj.
, a potem wybierz typ zależności, którą chcesz dodać, i postępuj zgodnie z wyświetlanymi instrukcjami.
- Kliknij OK, aby zapisać zmiany.
- Kliknij Kompilacja > Utwórz projekt, aby przetestować kompilację. w razie potrzeby usunąć nieuregulowane błędy.
Przeprowadź migrację przez utworzenie niestandardowego pliku kompilacji Gradle
Migracja projektu do Android Studio przez utworzenie nowego pliku kompilacji Gradle , aby wskazać istniejące pliki źródłowe, wykonaj te czynności:
- Zanim zaczniesz, utwórz kopię zapasową plików projektu w osobnym lokalizacji, ponieważ proces migracji modyfikuje zawartość projektu miejsce.
- W katalogu projektu utwórz plik o nazwie
build.gradle
, jeśli używasz Groovy, lubbuild.gradle.kts
, jeśli używasz skryptu Kotlin. Ten plik zawiera wszystkie informacje wymagane do uruchomienia kompilacji przez Gradle.Domyślnie Android Studio oczekuje, że projekt będzie zorganizowany w taki sposób: co pokazano na ilustracji 1.
Rysunek 1. Domyślna struktura projektu na Androida z modułu aplikacji. Za
settings.gradle
, dla Groovy lubsettings.gradle.kts
dla skryptu Kotlin ustawiasz repozytoria służące do znajdowania wtyczek i zależności wpluginManagement
idependencyResolutionManagement
bloki:Odlotowe
pluginManagement { repositories { google() mavenCentral() gradlePluginPortal() } } dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { google() mavenCentral() } } rootProject.name = "Test App" include ':app'
Kotlin
pluginManagement { repositories { google() mavenCentral() gradlePluginPortal() } } dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { google() mavenCentral() } } rootProject.name = "Test App" include(":app")
Ostrzeżenie: od 31 marca 2021 r. repozytorium JCenter jest dostępne tylko do odczytu. Więcej informacji: Aktualizacja usługi JCenter.
Wtyczka Androida do obsługi Gradle stosuje domyślne ustawiania źródeł projektu. Te zbiory źródłowe definiują katalogi używane do przechowywania różnych typów plików źródłowych. Gradle używa tych zbiorów źródłowych do określania lokalizacji konkretnego pliku . Jeśli Twój istniejący projekt nie jest zgodny z ustawieniami domyślnymi, możesz przenieś pliki tam, gdzie powinny, albo zmień ustawienia domyślne zestawów źródłowych, aby Gradle wiedziała, gdzie je znaleźć.
Więcej informacji o konfigurowaniu i dostosowywaniu pliku kompilacji Gradle znajdziesz w artykule Skonfiguruj kompilację.
Następnie określ, z których projektów bibliotek korzystasz.
Dzięki Gradle możesz nie muszą dodawać tych bibliotek jako projektów kodu źródłowego. Zamiast tego możesz znajdziesz je w bloku
dependencies{}
w pliku kompilacji. system kompilacji będzie obsługiwać te biblioteki za Ciebie, łącznie z pobieraniem scalania zasobów oraz wpisów manifestu. Poniżej dodaje instrukcje deklaracji dla wielu bibliotek AndroidaX do w blokudependencies{}
pliku kompilacji.Odlotowe
... dependencies { implementation fileTree(dir: 'libs', include: ['*.jar']) // AndroidX libraries implementation 'androidx.core:core-ktx:1.13.1' implementation 'androidx.appcompat:appcompat:1.7.0' implementation 'androidx.cardview:cardview:1.0.0' implementation 'com.google.android.material:material:1.7.0' implementation 'androidx.gridlayout:gridlayout:1.0.0' implementation 'androidx.leanback:leanback:1.1.0-rc02' implementation 'androidx.mediarouter:mediarouter:1.7.0' implementation 'androidx.palette:palette-ktx:1.0.0' implementation 'androidx.recyclerview:recyclerview:1.3.2' implementation 'androidx.annotation:annotation:1.8.2' // Note: these libraries require that the Google repository has been declared // in the pluginManagement section of the top-level build.gradle file. }
Kotlin
... dependencies { implementation(fileTree(mapOf("dir" to "libs", "include" to listOf("*.jar")))) // AndroidX libraries implementation("androidx.core:core-ktx:1.13.1") implementation("androidx.appcompat:appcompat:1.7.0") implementation("androidx.cardview:cardview:1.0.0") implementation("com.google.android.material:material:1.7.0") implementation("androidx.gridlayout:gridlayout:1.0.0") implementation("androidx.leanback:leanback:1.1.0-rc02") implementation("androidx.mediarouter:mediarouter:1.7.0") implementation("androidx.palette:palette-ktx:1.0.0") implementation("androidx.recyclerview:recyclerview:1.3.2") implementation("androidx.annotation:annotation:1.8.2") // Note: these libraries require that the Google repository has been declared // in the pluginManagement section of the top-level build.gradle.kts file. }
- Zapisz plik
build.gradle
, a następnie zamknij projekt w IntelliJ: Przejdź do katalogu projektu i usuń plik.idea
i wszystkie pliki IML w w projektach AI. - Uruchom Android Studio i kliknij Plik > Nowe > Importuj Projekt.
- Znajdź katalog projektu, wybierz
build.gradle
lubbuild.gradle.kts
utworzony przez Ciebie plik, a potem kliknij OK, aby zaimportować w projektach AI. - Kliknij Kompilacja > Utwórz projekt, aby przetestować plik kompilacji podczas tworzenia projektu i eliminować ewentualne błędy.
Dalsze kroki
Po przeniesieniu projektu do Android Studio dowiedz się więcej o tworzeniu za pomocą Gradle i uruchomić aplikację w Android Studio, czytając Utwórz i uruchom aplikację.
W zależności od projektu i procesu możesz też dowiedzieć się więcej o: kontrolę wersji, zarządzanie zależnościami i konfigurowanie Android Studio. Aby uzyskać zaczęło korzystać z Android Studio, Poznaj Android Studio.
Skonfiguruj kontrolę wersji
Android Studio obsługuje różne systemy kontroli wersji, w tym Git Mercurial i Subversion. Inne systemy kontroli wersji można dodawać za pomocą
Jeśli aplikacja jest już kontrolowana nad źródłem, konieczne może być jej włączenie Android Studio. W menu VCS kliknij Włącz integrację kontroli wersji. i wybierz odpowiedni system kontroli wersji.
Jeśli aplikacja nie podlega kontroli źródła, możesz ją skonfigurować po zaimportowaniu do Android Studio. Użyj opcji menu VCS w Android Studio, aby włączyć obsługa VCS dla odpowiedniego systemu kontroli wersji, tworzenie repozytorium, importowanie nowych plików do kontroli wersji oraz kontrolować inne wersje, operacje:
- W menu VCS w Android Studio kliknij Włącz kontrolę wersji. Integracja
- Wybierz system kontroli wersji, który chcesz powiązać z katalogiem głównym projektu i kliknij OK. W menu VCS znajdziesz teraz opcje kontroli wersji na podstawie wybranego systemu.
Uwaga: możesz też użyć menu Plik > Ustawienia > Opcja menu „Kontrola wersji” w menu do konfigurowania i modyfikowania wersji .
Więcej informacji na temat pracy z kontrolą wersji znajdziesz w artykule Dokumentacja kontroli wersji IntelliJ
Podpisywanie aplikacji
Jeśli certyfikat debugowania był już używany, może zostać wykryty podczas
importowanie danych. W tym przypadku Android Studio nadal wspomina o tym,
certyfikat. W przeciwnym razie konfiguracja debugowania będzie wykorzystywać plik wygenerowany w narzędziu Android Studio.
magazyn kluczy debugowania przy użyciu znanego hasła i klucza domyślnego o znanym
Hasło jest w języku: $HOME/.android/debug.keystore
. Ustawiono typ kompilacji do debugowania
aby automatycznie używać tej konfiguracji debugowania podczas uruchamiania lub debugowania projektu
w Android Studio.
Proces importu może również wykryć istniejący certyfikat wersji.
Jeśli nie zdefiniowano wcześniej żadnego certyfikatu wersji, dodaj podpisywanie wersji
do pliku build.gradle
lub build.gradle.kts
albo użyj
Kompilacja > Opcja w menu Wygeneruj podpisany plik APK, aby otworzyć opcję Wygeneruj podpisany plik APK
Czarodziej. Więcej informacji o podpisywaniu aplikacji znajdziesz tutaj
Podpisywanie aplikacji.
Dostosuj maksymalny rozmiar stosu w Android Studio
Domyślnie rozmiar stosu Android Studio nie może przekraczać 1280 MB. Jeśli jesteś pracujesz nad dużym projektem lub system ma dużo pamięci RAM, wydajność przez zwiększenie maksymalnego stosu rozmiar.
Aktualizacje oprogramowania
Android Studio aktualizuje się niezależnie od wtyczki Gradle, narzędzi do kompilacji przy użyciu narzędzi SDK. Możesz określić, których wersji chcesz używać z Androidem Studio.
Domyślnie Android Studio zapewnia automatyczne aktualizacje za każdym razem, gdy pojawi się nowa stabilna wersja jest już dostępna, ale możesz ją aktualizować częściej, wersji testowej lub beta.
Więcej informacji o aktualizowaniu Android Studio oraz korzystaniu z wersji przedpremierowej i beta wersji, przeczytaj o aktualizacjach.