Instalowanie i konfigurowanie NDK i CMake

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

  • Android Native Development Kit (NDK) to zestaw narzędzi, które pozwalają używać kodu C i C++ z Androidem.
  • CMake: zewnętrzne narzędzie do tworzenia kompilacji, które współpracuje z Gradle przy tworzeniu kodu natywnego bibliotece. 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. Po przeczytaniu i zaakceptowaniu warunków licencji możesz wstępnie zaakceptować licencje w skryptach przy użyciu tego polecenia:

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

Instalowanie NDK i CMake

Podczas instalacji pakietu NDK Android Studio wybiera najnowszą dostępną wersję NDK. Dla: dla większości projektów, wystarczy zainstalować tę domyślną wersję NDK. Jeśli Twój projekt wymaga co najmniej 1 konkretnej wersji NDK, możesz pobierać i konfigurować określone wersje. Pomaga to co zapewnia powtarzalne kompilacje w projektach, z których każdy zależy wersji NDK. Android Studio instaluje wszystkie wersje pakietu NDK Katalog android-sdk/ndk/.

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

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

  2. Kliknij kartę Narzędzia SDK.

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

    Obraz przedstawiający Menedżera pakietów SDK Rysunek 1. Okno Narzędzia SDK z widocznym polem NDK (obok siebie) opcja

  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 synchronizuje plik kompilacji i wykonuje kompilację. Wyeliminuj wszystkie występujące błędy.

Skonfiguruj konkretną wersję CMake

SDK Manager zawiera rozwidloną wersję 3.6.0 CMake i wersja 3.10.2. Projekty, które nie mają 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 W Menedżerze 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 może znaleźć wersji CMake wskazanej w polu build.gradle, wystąpi 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ę pakietu NDK

Aby zainstalować konkretną wersję pakietu NDK, wykonaj następujące czynności:

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

  2. Kliknij kartę Narzędzia SDK.

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

  4. Zaznacz pole wyboru NDK (obok siebie) i pola wyboru pod nim odpowiadają wersjom NDK, które chcesz zainstalować. Instalacje Android Studio wszystkie wersje pakietu NDK w systemie android-sdk/ndk/ katalogu.

    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 synchronizuje plik kompilacji i wykonuje 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

Konieczne może być skonfigurowanie wersji NDK w projekcie, jeśli prawda jest następujący:

  • 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 określ wersję za pomocą atrybutu android.ndkVersion w pliku build.gradle modułu, jak widać w kodzie poniżej przykład.

    Odlotowe

    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 nie określaj wersji NDK w pliku build.gradle. Domyślna wersja NDK dla różnych wersji AGP jest udokumentowana w Informacje o wersji AGP oraz Informacje o wcześniejszych wersjach AGP.