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ędną strukturę dla wszystkich plików i czyni je widocznymi w oknie 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óry umożliwia podzielenie projektu na osobne jednostki funkcjonalne. 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ć nowy moduł do projektu, kliknij Plik > Nowy > 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”.

Android Studio oferuje te typy modułów aplikacji:

  • Telefony i tablety
  • Automotive
  • Wear OS
  • Telewizja
  • Generator profilu podstawowego
  • Test porównawczy

Każdy moduł zawiera niezbędne pliki i niektóre szablony kodu odpowiednie dla danej aplikacji lub danego 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 za pomocą modułów funkcji możesz udostępniać użytkownikom określone funkcje aplikacji na żądanie lub jako aplikacje błyskawiczne za pomocą Google Play Instant.

Android Studio oferuje te typy modułów funkcji:

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

Więcej informacji: Play Feature Delivery

Moduł Biblioteka
Pozwala na przechowywanie kodu wielokrotnego użytku, którego możesz używać jako zależności w innych modułach aplikacji lub importować do innych projektów. 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 te typy modułów biblioteki:

  • 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. Wynik kompilacji to plik archiwum Androida (AAR), który możesz dodać jako zależność do 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 mogą jednak zawierać natywny kod źródłowy C++. Wynik kompilacji to plik archiwum Androida (AAR), który możesz dodać jako zależność do modułów aplikacji na Androida.
  • Biblioteka Java lub Kotlin: zawiera tylko pliki źródłowe w języku Java lub Kotlin. Wynik kompilacji to plik archiwum Java (JAR), który możesz dodać jako zależność do modułów aplikacji na Androida lub innych projektów w języku 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:

Groovy

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

Kotlin

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

Pliki projektu

Domyślnie Android Studio wyświetla pliki projektu w widoku 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.
  • Pokazuje wszystkie pliki manifestu dla każdego modułu w grupie na poziomie modułu, jeśli masz różne pliki manifestu dla różnych wersji produktu i typów kompilacji.
  • Wyświetla wszystkie alternatywne pliki zasobów w jednej grupie, a nie w osobnych folderach dla każdego modyfikatora zasobu. Na przykład wszystkie wersje ikony w menu 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.
res
Zawiera wszystkie zasoby niebędące kodem, takie jak ciągi tekstowe interfejsu użytkownika i obrazy bitmapowe, podzielone na odpowiednie podkatalogi. Więcej informacji 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 zobaczysz 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 modułu w tych podkatalogach:
androidTest/
Zawiera kod do testów narzędziowych przeprowadzanych na urządzeniu z Androidem. Więcej informacji znajdziesz w artykule Testowanie w Android Studio.
cpp/
Zawiera natywny kod w C lub C++ wykorzystujący język JNI (Java Native Interface). Więcej informacji znajdziesz w dokumentacji NDK na Androida.
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 poszczególnych jej komponentów. Więcej informacji znajdziesz w omówieniu pliku manifestu 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 informacji znajdziesz w omówieniu zasobów aplikacji.
assets/
Zawiera pliki, które zostaną skompilowane w pliku APK w niezmienionej formie. Przykład: to dobre miejsce na tekstury i dane gier. Możesz poruszać się po tym katalogu w taki sam sposób jak w typowym systemie plików, używając identyfikatorów URI, a pliki odczytywać jako strumień 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ł)
Określa konfiguracje kompilacji dotyczące konkretnego modułu. build.gradle to poprawna nazwa pliku, jeśli używasz skryptu Groovy jako języka skryptu kompilacji, a 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: określa lokalizację pakietu JDK, pakietu SDK Androida i NDK Androida, których używa projekt.
  • Zmienna: umożliwia edytowanie zmiennych używanych w skryptach kompilacji.
  • Moduły: umożliwia edytowanie konfiguracji kompilacji dla poszczególnych modułów, w tym docelowego i minimalnego pakietu SDK, sygnatury aplikacji oraz zależności bibliotek. Strona ustawień każdego modułu jest podzielona na te karty:
    • Właściwości: określa wersje pakietu SDK i narzędzia kompilacji, których należy użyć do skompilowania modułu.
    • Podpisywanie: określa certyfikat, którego chcesz użyć do podpisania aplikacji.

  • Zależności: lista zależności tego modułu od bibliotek, plików i modułów. 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żliwiają konfigurowanie różnych wersji i typów kompilacji w projekcie.

    • Wersje: umożliwiają tworzenie wielu wersji, z których każda określa zestaw ustawień konfiguracji, takich jak minimalna i docelowa wersja pakietu SDK modułu oraz kod i nazwa wersji.

      Możesz np. zdefiniować jedną wersję, która ma minimalną wersję pakietu SDK 21 i docelową wersję pakietu SDK 29, oraz drugą wersję, która ma minimalną wersję pakietu SDK 24 i docelową wersję pakietu SDK 33.

    • Typy kompilacji: umożliwia tworzenie i modyfikowanie kompilacji. konfiguracji znajdziesz w artykule Konfigurowanie wariantów kompilacji. Domyślnie każdy moduł ma typ kompilacji debug i release. W razie potrzeby możesz zdefiniować więcej typów.