Instalowanie i konfigurowanie NDK i CMake

Aby skompilować i debugować kod natywny aplikacji, potrzebujesz tych komponentów:

  • Pakiet Native Development Kit (NDK) na Androida: zestaw narzędzi umożliwiający korzystanie z kodu C i C++ na Androidzie.
  • CMake: zewnętrzne narzędzie do kompilacji, które współpracuje z Gradle w celu kompilowania natywnej biblioteki. Jeśli zamierzasz używać tylko polecenia ndk-build, nie potrzebujesz tego komponentu.
  • LLDB: debuger używany przez Android Studio do debugowania kodu natywnego. Domyślnie LLDB zostaną zainstalowane razem z Android Studio.

Na tej stronie dowiesz się, jak zainstalować te komponenty automatycznie lub za pomocą Android Studio lub narzędzie sdkmanager, aby pobrać i zainstalować je ręcznie.

Automatycznie zainstaluj NDK i CMake

Wtyczka Androida do obsługi Gradle w wersji 4.2.0 lub nowszej może automatycznie instalować wymagane pakiety NDK i CMake przy pierwszym kompilowaniu projektu, o ile licencje użytkowników zostały wcześniej zaakceptowane. Jeśli warunki licencji zostały już przez Ciebie przeczytane i zaakceptowane, możesz wstępnie zaakceptować licencje w skryptach za pomocą tego polecenia:

   yes | ${sdk}/cmdline-tools/latest/bin/sdkmanager --licenses

Zainstaluj NDK i CMake

Podczas instalowania NDK Android Studio wybiera najnowszą dostępną wersję NDK. W przypadku większości projektów wystarczy zainstalowanie tej domyślnej wersji NDK. Jeśli jednak Twój projekt wymaga konkretnej wersji NDK, możesz pobrać i skonfigurować te wersje. Pomaga to co zapewnia powtarzalne kompilacje w projektach, z których każdy zależy wersji NDK. Android Studio instaluje wszystkie wersje NDK w katalogu android-sdk/ndk/.

Aby zainstalować CMake i domyślny pakiet NDK w Android Studio, wykonaj te czynności:

  1. W otwartym projekcie kliknij Narzędzia > Menedżer SDK.

  2. Kliknij kartę Narzędzia pakietu SDK.

  3. Zaznacz pola wyboru NDK (obok siebie) i CMake.

    Ilustracja przedstawiająca Menedżera pakietu SDK Rysunek 1. Okno Narzędzia SDK z opcją NDK (obok siebie)

  4. Kliknij OK.

    Okno dialogowe z informacją, ile miejsca na dysku zużywa pakiet NDK.

  5. Kliknij OK.

  6. Po zakończeniu instalacji kliknij Zakończ.

  7. Twój projekt automatycznie zsynchronizuje plik kompilacji i przeprowadzi kompilację. Wyeliminuj wszystkie występujące błędy.

Konfigurowanie konkretnej wersji CMake

SDK Manager zawiera wersję 3.6.0 rozwidloną CMake i wersja 3.10.2. Projekty, w których nie ma ustawionej określonych wersji CMake są tworzone przy użyciu CMake 3.10.2. Do ustaw wersję CMake, do pliku build.gradle modułu dodaj ten kod:

Odlotowe

android {
    ...
    externalNativeBuild {
        cmake {
            ...
            version "cmake-version"
        }
    }
}

Kotlin

android {
    ...
    externalNativeBuild {
        cmake {
            ...
            version = "cmake-version"
        }
    }
}

Jeśli chcesz użyć wersji CMake, która nie jest uwzględniona w Menedżerze pakietu SDK, wykonaj te czynności:

  1. Pobierz i zainstaluj CMake z oficjalnej witryny CMake.
  2. Określ wersję CMake, która ma być używana przez Gradle w module build.gradle.

  3. Dodaj ścieżkę do instalacji CMake do środowiska PATH lub umieść ją w pliku local.properties projektu jako wyświetlane. Jeśli Gradle nie znajdzie wersji CMake określonej w pliku build.gradle, pojawi się błąd kompilacji.

    # If you set this property, Gradle no longer uses PATH to find CMake.
cmake.dir = "path-to-cmake"</pre>

  4. Jeśli na Twoim urządzeniu nie jest jeszcze zainstalowany system kompilacji Ninja odwiedź oficjalną stronę Ninja, oraz pobierz i zainstaluj najnowszą wersję Ninja dostępną dla Twojego systemu operacyjnego. Pamiętaj, aby dodać ścieżkę do instalacji Ninja do pliku Zmienna środowiskowa PATH.

Zainstaluj konkretną wersję NDK

Aby zainstalować konkretną wersję NDK, wykonaj te czynności:

  1. Po otwarciu projektu kliknij Narzędzia > Menedżer pakietów SDK.

  2. Kliknij kartę Narzędzia pakietu SDK.

  3. Zaznacz pole wyboru Pokaż szczegóły pakietu.

  4. Zaznacz pole wyboru NDK (obok siebie) oraz pola wyboru poniżej, które odpowiadają wersjom NDK, które chcesz zainstalować. Android Studio instaluje wszystkie wersje NDK w katalogu android-sdk/ndk/.

    Obraz okna SDK Tools Rysunek 2. Okno Narzędzia SDK z widocznym polem NDK (obok siebie) opcje

  5. Kliknij OK.

    Okno dialogowe z informacją o ilości miejsca wykorzystywanego przez pakiety NDK.

  6. Kliknij OK.

  7. Po zakończeniu instalacji kliknij Zakończ.

  8. Twój projekt automatycznie zsynchronizuje plik kompilacji i przeprowadzi kompilację. Wyeliminuj wszystkie występujące błędy.

  9. Skonfiguruj każdy moduł za pomocą wersji NDK których ma używać. Jeśli używasz Androida Studio 3.6 lub nowszego, określić wersję, wtyczka Androida do obsługi Gradle wybiera wersję o których wiemy, że są zgodne.

Skonfiguruj określone wersje NDK w projekcie

Może być konieczne skonfigurowanie wersji NDK w projekcie, jeśli spełniony jest jeden z tych warunków:

  • Twój projekt jest dziedziczony i musisz użyć określonych wersji NDK oraz wtyczki Androida do obsługi Gradle (AGP). Więcej informacji: Skonfiguruj NDK na potrzeby wtyczki Androida do obsługi Gradle.

  • Masz zainstalowanych wiele wersji NDK i chcesz użyć określonej jeden. W tym przypadku wskaż wersję za pomocą właściwości android.ndkVersion w pliku build.gradle modułu, jak pokazano w tym przykładzie kodu.

    Groovy

    android {
    ndkVersion "major.minor.build" // e.g.,  ndkVersion "21.3.6528147"
}

    Kotlin

    android {
    ndkVersion = "major.minor.build" // e.g.,  ndkVersion "21.3.6528147"
}

Domyślna wersja NDK na wersję AGP

Przed opublikowaniem każda wersja AGP jest dokładnie testowana przy użyciu najnowszej stabilnej wersji NDK już w danej chwili. Ta wersja NDK jest używana do kompilowania projektów, jeśli w pliku build.gradle nie określisz wersji NDK. Domyślna wersja NDK dla różnych wersji AGP jest opisana w informacjach o wersji AGP i informacjach o poprzednich wersjach AGP.