Struktura projektu w Android Studio – folder „res” i jego zawartość

1. Wstęp

Każda aplikacja Android składa się z wielu plików i folderów, które wspólnie tworzą kompletny projekt. Zrozumienie struktury projektu w Android Studio to jeden z najważniejszych kroków w nauce programowania aplikacji. Dzięki temu wiesz, gdzie umieszczać kod, pliki graficzne, teksty, kolory, style i układ interfejsu.

Dzisiaj poznamy strukturę projektu oraz szczegółowo omówimy folder „res”, który przechowuje zasoby aplikacji.

2. Cele lekcji

Uczeń po lekcji:

  • zna strukturę projektu Android Studio,
  • rozróżnia główne foldery i ich przeznaczenie,
  • potrafi wskazać, gdzie znajdują się pliki XML odpowiedzialne za interfejs, kolory, teksty i style,
  • rozumie, do czego służą foldery: layout, values, mipmap.

3. Struktura projektu w Android Studio

Po utworzeniu nowego projektu zobaczysz po lewej stronie (w panelu Project, widok „Android”) podstawowe foldery i pliki. Najważniejsze z nich to:

  • manifests – zawiera plik AndroidManifest.xml, który opisuje podstawowe informacje o aplikacji (nazwa, ikona, uprawnienia, główna aktywność),
  • java – zawiera kod źródłowy aplikacji w języku Java lub Kotlin,
  • res – to folder zasobów (ang. resources), czyli wszystko, co nie jest kodem: pliki graficzne, układy ekranów, teksty, kolory, style itp.

Dzisiaj skupimy się właśnie na folderze res.

4. Folder „res” – zasoby aplikacji

Folder res zawiera różne podfoldery, z których każdy przechowuje inny typ zasobów. Dzięki temu aplikacja jest uporządkowana, a zmiany można wprowadzać w jednym miejscu bez konieczności edycji kodu.

a) Folder layout – pliki XML z układem aplikacji

W folderze res/layout znajdują się pliki XML, które opisują układ interfejsu użytkownika (czyli rozmieszczenie elementów takich jak przyciski, pola tekstowe, obrazy).

Najczęściej spotykany plik to: activity_main.xml – główny ekran aplikacji.

Każdy element interfejsu ma swoją nazwę XML, np.

<Button
    android:id="@+id/button1"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:text="Kliknij mnie" />

Pliki XML można edytować w dwóch trybach:

  • Code – ręczna edycja kodu XML,
  • Design – graficzny edytor, w którym elementy można przeciągać myszą.

b) Folder values – teksty, kolory i style aplikacji

W folderze res/values znajdują się różne pliki XML, które definiują wartości używane w aplikacji:

  1. strings.xml – przechowuje teksty (np. napisy na przyciskach, tytuły). Dzięki temu można łatwo tłumaczyć aplikację na inne języki.

    <string name="app_name">Moja aplikacja</string>
<string name="button_text">Kliknij mnie</string>

  2. colors.xml – definiuje kolory używane w aplikacji.

    <color name="primaryColor">#2196F3</color>
<color name="textColor">#FFFFFF</color>

  3. styles.xml – zawiera style (czyli zestawy ustawień wyglądu, np. dla przycisków lub tekstów).

    <style name="AppTheme" parent="Theme.MaterialComponents.DayNight.DarkActionBar">
    <item name="colorPrimary">@color/primaryColor</item>
    <item name="colorAccent">@color/textColor</item>
</style>

Dzięki folderowi values można zmieniać wygląd aplikacji w jednym miejscu, bez edycji każdego elementu osobno.

c) Folder mipmap – ikony aplikacji

Folder res/mipmap zawiera różne wersje ikon aplikacji. Każdy folder (mipmap-mdpi, mipmap-hdpi, mipmap-xhdpi, mipmap-xxhdpi) odpowiada za inną rozdzielczość ekranu. Android automatycznie wybiera odpowiednią ikonę w zależności od urządzenia.

Najczęściej spotykany plik: ic_launcher.png – główna ikona aplikacji widoczna na ekranie telefonu.

d) Inne foldery w „res”

W miarę rozwoju aplikacji mogą się pojawić także inne foldery, np.:

  • drawable – pliki graficzne (np. tła, ilustracje),
  • menu – definicje menu aplikacji,
  • raw – dodatkowe zasoby (np. dźwięki, pliki tekstowe).

5. Dlaczego folder „res” jest tak ważny?

  • Ułatwia zarządzanie wyglądem aplikacji,
  • Oddziela kod od zasobów,
  • Pozwala łatwo zmieniać kolory, style i teksty,
  • Umożliwia tworzenie wersji językowych aplikacji (np. values-pl dla języka polskiego).

6. Ćwiczenia wprowadzające

Zadanie 1: Otwórz dowolny projekt w Android Studio i rozwiń w panelu Project strukturę folderów aż do folderu res.

Zadanie 2: Otwórz plik activity_main.xml z folderu layout i przełącz widok na Split (kod + design).

Zadanie 3: Otwórz plik strings.xml i dodaj nowy napis o nazwie welcome_text z treścią „Witaj w mojej aplikacji!”.

Zadanie 4: W pliku colors.xml dodaj nowy kolor o nazwie secondaryColor i dowolnej wartości HEX.

Zadanie 5: Otwórz folder mipmap i znajdź plik ic_launcher.