Omówienie projektów

Projekt w Android Studio zawiera wszystkie elementy, które definiują obszaru roboczego aplikacji – od kodu źródłowego i zasobów po testowanie kodu i kompilację konfiguracji.

Gdy rozpoczynasz nowy projekt, Android Studio tworzy niezbędne dla wszystkich plików i sprawia, że są one widoczne Okno Projekt w Android Studio. Aby otworzyć okno, wybierz Wyświetl > Okna narzędziowe > Projekt.

Ta strona zawiera przegląd najważniejszych komponentów projektu.

Moduły

Moduł to zbiór plików źródłowych i ustawień kompilacji, które pozwalają na podzielenie projektu na oddzielne jednostki funkcji. Twoje może składać się z jednego lub wielu modułów, z których jeden może pełnić funkcję drugiego zależności. Każdy moduł możesz samodzielnie kompilować, testować i debugować.

Moduły dodatkowe są przydatne przy tworzeniu bibliotek kodu w Własny projekt lub jeśli chcesz utworzyć różne zestawy kodu i zasobów dla różnych typów urządzeń, takich jak telefony czy urządzenia do noszenia, ale zachowaj wszystkie pliki w ramach tego samego projektu i udostępniać im kod.

Aby dodać do projektu nowy moduł, kliknij Plik > Nowe > Nowy moduł.

Android Studio zawiera kilka różnych typów modułów:

Moduł aplikacji na Androida
Udostępnia kontener na zasoby aplikacji kodu źródłowego, plików zasobów i ustawień na poziomie aplikacji, takich jak pliku kompilacji na poziomie modułu i pliku manifestu Androida. Kiedy utworzysz nowy projekt, domyślnym modułem aplikacji będzie „aplikacja”.

Oferty Android Studio następujące typy modułów aplikacji:

  • Telefon i Tablety
  • Automotive
  • Wear OS
  • Telewizja
  • Generator profili bazowych
  • Test porównawczy

Każdy moduł zawiera niezbędne pliki i szablony kodu, odpowiednie dla danej aplikacji lub typu urządzenia.

Więcej informacji na temat dodawania modułu znajdziesz na stronie Dodawanie modułu na nowe urządzenie

Moduł funkcji
Reprezentuje modułową funkcję aplikacji, która może korzystać z Google Play Dostawa funkcji. Na przykład dzięki modułom funkcji można udostępniać użytkownikom z niektórymi funkcjami aplikacji na żądanie lub jako aplikacje błyskawiczne, Aplikacja błyskawiczna w Google Play.

Android Studio zawiera następujące typy modułów funkcji:

  • Moduł funkcji dynamicznych
  • Moduł biblioteki funkcji dynamicznych reklam błyskawicznych

Więcej informacji: Play Feature Delivery

Moduł Biblioteka
Udostępnia pojemnik na kod wielokrotnego użytku, można użyć jako zależności w innych modułach aplikacji lub zaimportować do innych, w projektach AI. Z konstrukcji moduł biblioteki jest taki sam jak moduł aplikacji, ale po utworzeniu zamiast pakietu APK tworzy plik archiwum kodu, więc nie można go zainstalować urządzenia.

W oknie Utwórz nowy moduł Android Studio oferuje następujące typy modułów bibliotecznych:

  • Biblioteka Androida: zawiera wszystkie obsługiwane typy plików. w projekcie Androida z wyjątkiem natywnego kodu C++, w tym kodu źródłowego Java i Kotlin, zasobów i plików manifestu. Wynikiem kompilacji jest plik Android Archive (AAR), który możesz dodać jako dla modułów aplikacji na Androida.
  • Biblioteka natywna na Androida: zawiera wszystkie obsługiwane typy plików. w projekcie Androida, podobnie jak w Bibliotece Androida. Biblioteki natywne Androida może zawierać natywny kod źródłowy w C++. Wynikiem kompilacji jest plik Android Archive (AAR), jako zależność w modułach aplikacji na Androida.
  • Biblioteka Java lub Kotlin: zawiera tylko pliki źródłowe w języku Java lub Kotlin. Wynikiem kompilacji jest plik Java Archive (JAR), który można dodać jako zależności od modułów aplikacji na Androida albo innych projektów Kotlin lub Java.

Moduły są czasami nazywane podprojektami, ponieważ Gradle określa też moduły jako projekty.

Gdy utworzysz moduł biblioteki i chcesz dodać go jako zależność do modułu modułu aplikacji na Androida, musisz go zadeklarować w ten sposób:

Odlotowe

dependencies {
    implementation project(':my-library-module')
}

Kotlin

dependencies {
    implementation(project(":my-library-module"))
}

Pliki projektu

Domyślnie Android Studio wyświetla pliki projektu w Android. Ten widok nie odzwierciedla rzeczywistej hierarchii plików na dysku. Organizacja jest posortowana według: modułów i typów plików, co upraszcza nawigację między kluczowymi plikami źródłowymi projektu, ukrywanie niektóre pliki lub katalogi, które nie są często używane.

Niektóre strukturalne różnice między widokiem Androida a na dysku to widok Androida:

  • Wyświetla wszystkie pliki konfiguracji związane z kompilacją w najwyższym poziomie grupę Gradle Script.
  • Jeśli mieć różne pliki manifestu dla różnych rodzajów usług i typów kompilacji.
  • Pokazuje wszystkie alternatywne pliki zasobów w jednej grupie zamiast w osobnych folderach dla każdego kwalifikatora zasobu. Na przykład cała gęstość wersje ikony programu uruchamiającego są widoczne obok siebie.

W każdym module aplikacji na Androida pliki są wyświetlane w następujących grupach:

manifesty
Zawiera plik AndroidManifest.xml.
Java
Zawiera pliki kodu źródłowego Kotlin i Javy, rozdzielone nazwami pakietów z kodem testowym JUnit.
rozdzielczość
Obejmuje wszystkie zasoby, które nie są kodem, takie jak ciągi znaków w interfejsie bitmapy podzielone na odpowiednie podkatalogi. Więcej informacji na temat konfiguracji o możliwych typach zasobów znajdziesz w artykule Omówienie zasobów aplikacji.
.
.

Widok projektu

Aby zobaczyć rzeczywistą wartość strukturę plików projektu, w tym wszystkie pliki ukryte w widoku Androida, w menu wybierz Projekt. u góry okna Projekt.

Po wybraniu widoku Projekt możesz zobaczyć znacznie więcej plików i katalogów, w tym:

module-name/
build/
Zawiera dane wyjściowe kompilacji.
libs/
Zawiera biblioteki prywatne.
src/
Zawiera wszystkie pliki kodu i zasobów dla modułu w następujących sekcjach podkatalogi:
androidTest/
Zawiera kod do testów narzędziowych przeprowadzanych na urządzeniu z Androidem. Więcej informacji: Przetestuj w Android Studio.
cpp/
Zawiera natywny kod w C lub C++ wykorzystujący język JNI (Java Native Interface). Więcej informacji: dokumentacji Androida NDK.
main/
Zawiera „główny” pliki zbioru źródłowego: kod i zasoby Androida, wspólne dla wszystkich wariantów kompilacji (pliki innych wariantów kompilacji są w katalogach równorzędnych, takich jak src/debug/, typ kompilacji do debugowania):
AndroidManifest.xml
Opisuje charakter aplikacji i każdy z jej komponentów. Więcej informacji: manifest aplikacji .
java/
Zawiera Kotlin lub Javę albo oba te źródła, jeśli aplikacja zawiera zarówno Kotlin, jak i javę. kodu źródłowego.
kotlin/
Zawiera tylko źródła kodu Kotlin.
res/
Zawiera zasoby aplikacji, takie jak pliki rysowalne i pliki znaków interfejsu. Więcej więcej informacji zawiera zasobów dotyczących aplikacji.
assets/
Zawiera pliki, które zostaną skompilowane w pliku APK w niezmienionej formie. Przykład: to dobre miejsce na tekstury i dane gier. Dostępne opcje poruszaj się po nim tak samo jak w typowym systemie plików, przy użyciu identyfikatory URI i pliki do odczytu w postaci strumienia bajtów za pomocą funkcji AssetManager
test/
Zawiera kod do lokalnych testów przeprowadzanych na hoście JVM.
build.gradle lub build.gradle.kts (moduł)
Definiuje konfiguracje kompilacji w poszczególnych modułach. build.gradle to jeśli używasz Groovy jako języka skryptu kompilacji, build.gradle.kts, jeśli używasz skryptu Kotlin.
build.gradle lub build.gradle.kts (projekt)
Ta wartość określa konfigurację kompilacji, która ma zastosowanie do wszystkich modułów. build.gradle to jeśli używasz Groovy jako języka skryptu kompilacji, build.gradle.kts, jeśli używasz skryptu Kotlin. Ten plik jest integralną częścią projektu, więc zachowaj go w ramach kontroli wersji z pozostałym kodem źródłowym.

Informacje o innych plikach kompilacji: Skonfiguruj kompilację.

.
.

Ustawienia struktury projektu

Aby zmienić różne ustawienia projektu w Android Studio, otwórz Okno Struktura projektu, klikając Plik > Struktura projektu. Zawiera on w tych sekcjach:

  • Projekt: ustawia wersję Gradle i wtyczkę Androida do obsługi Gradle i nazwę lokalizacji repozytorium.
  • Lokalizacja pakietu SDK: ustawia lokalizację pakietu JDK, Android SDK oraz Android NDK, z których korzysta Twój projekt.
  • Zmienne: pozwala edytować zmienne używane w kompilacji. skryptów.
  • Moduły: umożliwiają edytowanie kompilacji związane z określonym modułem. w tym docelowy i minimalny pakiet SDK, podpis aplikacji i zależności od bibliotek. Strona ustawień każdego modułu jest podzielona na następujące karty:
    • Właściwości: określa wersje pakietu SDK i kompilacji. oraz narzędzia służące do skompilowania modułu.
    • Podpisywanie: określa certyfikat, który ma być używany podpisz

  • Zależności: wyświetla listę biblioteki, pliku i modułu. w tym module. Możesz dodawać, modyfikować i usuwać zależności z tego panelu. Więcej informacji o zależnościach modułów znajdziesz w artykule: Skonfiguruj warianty kompilacji.

  • Warianty kompilacji: umożliwia skonfigurowanie różnych smaków i typów kompilacji. do swojego projektu.

    • Smaki: pozwala utworzyć wiele smaków kompilacji, gdzie każdy rodzaj określa zestaw ustawień konfiguracji, takich jak minimalną i docelową wersję pakietu SDK modułu oraz kod wersji nazwę wersji.

      Możesz np. zdefiniować jeden smak, który ma SDK w wersji 21 i 29 oraz inny rodzaj, który ma SDK w wersji 24 lub nowszej albo docelowy pakiet SDK w wersji 33.

    • Typy kompilacji: umożliwia tworzenie i modyfikowanie kompilacji. konfiguracji znajdziesz w artykule Konfigurowanie wariantów kompilacji. Domyślnie każdy moduł zawiera funkcje debugowania release, a w razie potrzeby możesz zdefiniować ich więcej.