Omówienie projektów

Projekt w Android Studio zawiera wszystko, co definiuje Twoją przestrzeń roboczą dla aplikacji, od kodu źródłowego i komponentów po kod testowy i konfiguracje kompilacji.

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. Twój projekt może zawierać 1 lub wiele modułów, a jeden moduł może używać innego modułu jako zależności. Każdy moduł możesz samodzielnie kompilować, testować i debugować.

Dodatkowe moduły są przydatne podczas tworzenia bibliotek kodu w ramach własnego projektu lub gdy chcesz utworzyć różne zestawy kodu i zasobów dla różnych typów urządzeń, np. telefonów i urządzeń do noszenia, ale zachować wszystkie pliki w ramach tego samego projektu i udostępnić część kodu.

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
Przechowuje kod źródłowy, pliki zasobów i ustawienia na poziomie aplikacji, takie jak plik kompilacji na poziomie modułu i plik 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 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
Przedstawia modułową funkcję aplikacji, która może korzystać z Play Feature Delivery. 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. Jest ona zamiast tego zorganizowana według modułów i typów plików, aby ułatwić nawigację między kluczowymi plikami źródłowymi projektu, ukrywając jednocześnie niektóre pliki lub katalogi, których nie używa się często.

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

  • Wyświetla wszystkie pliki konfiguracji związane z kompilacją projektu w grupie najwyższego poziomu Skrypt Gradle.
  • Jeśli mieć różne pliki manifestu dla różnych rodzajów usług i typów kompilacji.
  • Wyświetla wszystkie alternatywne pliki zasobów w jednej grupie zamiast w osobnych folderach dla każdego modyfikatora 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 Java, rozdzielone nazwami pakietów, w tym kod testów JUnit.
res
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 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 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 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 każdy z jej komponentów. Więcej informacji: manifest aplikacji .
java/
 Kod źródłowy Kotlin lub Java albo oba, jeśli aplikacja zawiera kod źródłowy Kotlin i Java.
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: umożliwia edytowanie zmiennych używanych w kompilacji. skryptów.
  • 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 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órego chcesz użyć do podpisania aplikacji.

  • 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żliwiają konfigurowanie różnych wersji i typów kompilacji w projekcie.

    • 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.