Pierwsze kroki z pakietem NDK

Natywna wersja deweloperska (NDK) to zestaw narzędzi, które umożliwiają korzystanie i kodu w C++ na Androidzie oraz biblioteki platformy, których można używać do zarządzania aktywności natywnych oraz dostęp do komponentów urządzeń fizycznych, takich jak czujniki dotykowe wprowadzanie danych. Pakiet NDK może nie być odpowiedni dla większości początkujących użytkowników Androida dla programistów, którzy korzystają wyłącznie z kodu w Javie i interfejsów API platformy i aplikacjami. NDK może być jednak przydatne w przypadkach, gdy trzeba któreś z tych problemów:

• Zwiększ wydajność urządzenia, aby zmniejszyć opóźnienie lub działało w aplikacjach wymagających dużej mocy obliczeniowej, takich jak gry lub symulacje fizyki.
• Wykorzystaj ponownie własne lub innych deweloperów biblioteki C lub C++.

W Android Studio 2.2 lub nowszym możesz: używaj narzędzia NDK do skompilowania kodu C i C++ w natywnej biblioteki i spakowania go do pliku APK za pomocą Gradle, zintegrowanego systemu kompilacji IDE. Twój kod w Javie mogą następnie wywoływać funkcje w bibliotece natywnej za pomocą platformy JNI (Java Native Interface). Aby się uczyć Więcej informacji o Gradle i systemie kompilacji Androida znajdziesz w artykule Konfigurowanie kompilacji.

Domyślnym narzędziem kompilacji w Android Studio do kompilowania bibliotek natywnych jest CMake. Android Studio też obsługuje polecenie ndk-build, ponieważ jest duży istniejących projektów, które korzystają z narzędzia do kompilacji. Jeśli jednak używasz podczas tworzenia nowej biblioteki natywnej, użyj CMake.

Niniejszy przewodnik zawiera informacje potrzebne do rozpoczęcia korzystania z NDK w Android Studio. Jeśli nie masz najnowszej wersji Androida Studio, pobierz i zainstaluj ją teraz.

Uwaga: użytkownicy korzystający z wersji eksperymentalnej Gradle: rozważ przejście na wtyczkę w wersji 2.2.0 lub nowszej i używanie CMake lub ndk-build do tworzenia bibliotek natywnych, jeśli któraś z tych sytuacji: projekt natywny używa już CMake lub ndk-build; wolisz użyć stabilnej wersji wersję systemu kompilacji Gradle; lub potrzebujesz pomocy w zakresie dodatków, na przykład CCache. W przeciwnym razie możesz nadal korzystać z eksperymentalną wersję Gradle i wtyczki na Androida.

Pobierz NDK i narzędzia

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

• Android Native Development Kit (NDK) to zestaw narzędzi, dzięki którym kodu C i C++ na Androidzie.
• CMake: zewnętrznego narzędzia do kompilacji, które współpracuje z Gradle przy tworzeniu biblioteki natywnej. Nie potrzebujesz tego komponentu, jeśli planujesz używać go tylko ndk-build.
• LLDB: debuger używany przez Android Studio do debugowania kodu natywnego.

Informacje o instalowaniu tych komponentów znajdziesz w artykule Instalowanie i konfigurowanie pakietów NDK i CMake.

Tworzenie lub importowanie projektu natywnego

Po skonfigurowaniu Android Studio możesz po prostu utworzyć nowy projekt Obsługa języka C/C++. Jeśli jednak chcesz dodać lub zaimportować kod natywny do istniejącego projektu Android Studio, musisz skorzystać z tej podstawowej procedury:

1. Utwórz nowe natywnych plików źródłowych i dodać je do projektu Android Studio.
   • Możesz pominąć ten krok, jeśli masz już kod natywny lub chcesz zaimportować gotową bibliotekę natywną.
2. Utwórz skrypt kompilacji CMake, który wskaże CMake, jak utworzyć źródła natywne; do biblioteki. Potrzebujesz go również, jeśli importujesz i z wykorzystaniem gotowych bibliotek lub bibliotek platformy.
   • Możesz pominąć ten krok, jeśli Twoja biblioteka natywna ma już CMakeLists.txt skrypt kompilacji lub używa polecenia ndk-build i zawiera Android.mk skrypt kompilacji.
3. Połącz Gradle z do biblioteki natywnej, podając ścieżkę do pliku CMake lub ndk-build skrypt. Gradle używa skryptu kompilacji do zaimportowania kodu źródłowego projekt Android Studio i spakuj bibliotekę natywną (plik SO) do plik APK.

   Uwaga: jeśli Twój istniejący projekt używa wycofanych plików ndkCompile, otwórz build.properties i usuń następujący wiersz kodu zanim skonfigurujesz Gradle tak, aby używał CMake lub ndk-build:

   // Remove this line
   android.useDeprecatedNdk = true
   

4. Utwórz i uruchom aplikację, klikając Uruchom . Dodanie Gradle w procesie CMake lub ndk-build jako zależność do kompilowania, kompilacji i spakować bibliotekę natywną do pliku APK.

Gdy aplikacja zostanie uruchomiona na urządzeniu fizycznym lub w emulatorze, możesz używać w Android Studio, aby debugować aplikację. Więcej informacji na temat pakietu NDK i jego komponentów znajdziesz na stronie Pojęcia.