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:
Po otwarciu projektu kliknij Narzędzia > Menedżer pakietów SDK.
Kliknij kartę Narzędzia SDK.
Zaznacz pola wyboru NDK (obok siebie) i CMake.
Rysunek 1. Okno Narzędzia SDK z widocznym polem NDK (obok siebie) opcja
Kliknij OK.
Okno dialogowe z informacją, ile miejsca na dysku zużywa pakiet NDK.
Kliknij OK.
Po zakończeniu instalacji kliknij Zakończ.
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:
- Pobierz i zainstaluj CMake z oficjalnej witryny CMake.
- Określ wersję CMake, która ma być używana przez Gradle w module
build.gradle
. Dodaj ścieżkę do instalacji CMake do środowiska
PATH
lub umieść ją w plikulocal.properties
projektu jako wyświetlane. Jeśli Gradle nie może znaleźć wersji CMake wskazanej w polubuild.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>
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:
Po otwarciu projektu kliknij Narzędzia > Menedżer pakietów SDK.
Kliknij kartę Narzędzia SDK.
Zaznacz pole wyboru Pokaż szczegóły pakietu.
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.Rysunek 2. Okno Narzędzia SDK z widocznym polem NDK (obok siebie) opcje
Kliknij OK.
Okno dialogowe z informacją o ilości miejsca wykorzystywanego przez pakiety NDK.
Kliknij OK.
Po zakończeniu instalacji kliknij Zakończ.
Twój projekt automatycznie synchronizuje plik kompilacji i wykonuje kompilację. Wyeliminuj wszystkie występujące błędy.
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 plikubuild.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 poprzednich wersjach AGP