সিমেক

Android NDK আপনার অ্যাপ্লিকেশনের জন্য C এবং C++ কোড কম্পাইল করতে CMake ব্যবহার করে সমর্থন করে। এই পৃষ্ঠাটি Android Gradle Plugin এর ExternalNativeBuild এর মাধ্যমে NDK-এর সাথে CMake কীভাবে ব্যবহার করতে হয় বা সরাসরি CMake ব্যবহার করার সময় আলোচনা করে।

CMake টুলচেন ফাইল

NDK একটি টুলচেইন ফাইলের মাধ্যমে CMake সমর্থন করে। টুলচেন ফাইলগুলি হল CMake ফাইল যা ক্রস-কম্পাইলিংয়ের জন্য টুলচেনের আচরণকে কাস্টমাইজ করে। NDK-এর জন্য ব্যবহৃত টুলচেন ফাইলটি NDK-এ <NDK>/build/cmake/android.toolchain.cmake এ অবস্থিত।

বিল্ড প্যারামিটার যেমন ABI, minSdkVersion , ইত্যাদি কমান্ড লাইনে দেওয়া হয় cmake চালু করার সময়। সমর্থিত আর্গুমেন্টের তালিকার জন্য, টুলচেইন আর্গুমেন্টস বিভাগটি দেখুন।

ব্যবহার

$ cmake \
    -DCMAKE_TOOLCHAIN_FILE=$NDK/build/cmake/android.toolchain.cmake \
    -DANDROID_ABI=$ABI \
    -DANDROID_PLATFORM=android-$MINSDKVERSION \
    $OTHER_ARGS

টুলচেইন আর্গুমেন্ট

নিম্নলিখিত আর্গুমেন্ট CMake টুলচেইন ফাইলে পাস করা যেতে পারে। যদি Gradle দিয়ে তৈরি করা হয়, তাহলে ExternalNativeBuild ডক্সে বর্ণিত android.defaultConfig.externalNativeBuild.cmake.arguments এ আর্গুমেন্ট যোগ করুন। যদি কমান্ড লাইন থেকে বিল্ডিং করা হয়, -D এর সাথে CMake-এ আর্গুমেন্ট পাস করুন। উদাহরণ স্বরূপ, armeabi-v7a-কে নিয়ন সাপোর্ট দিয়ে তৈরি না করতে বাধ্য করতে, পাস করুন -DANDROID_ARM_NEON=FALSE ।

ANDROID_ABI

লক্ষ্য ABI. সমর্থিত ABI সম্পর্কে তথ্যের জন্য, Android ABIs দেখুন।

ANDROID_ARM_MODE

armeabi-v7a-এর জন্য বাহু বা থাম্ব নির্দেশনা তৈরি করতে হবে কিনা তা নির্দিষ্ট করে। অন্যান্য ABI-এর জন্য কোন প্রভাব নেই। আরও তথ্যের জন্য, Android ABIs ডকুমেন্টেশন দেখুন।

ANDROID_ARM_NEON

armeabi-v7a এর জন্য NEON সক্ষম বা নিষ্ক্রিয় করে৷ অন্যান্য ABI-এর জন্য কোন প্রভাব নেই। API স্তরের জন্য ডিফল্ট সত্য ( minSdkVersion বা ANDROID_PLATFORM ) 23 বা নতুন, অন্যথায় মিথ্যা। আরও তথ্যের জন্য, নিয়ন সমর্থন ডকুমেন্টেশন দেখুন।

ANDROID_LD

কোন লিঙ্কার ব্যবহার করতে হবে তা নির্বাচন করে। lld বর্তমানে NDK-এর জন্য পরীক্ষামূলক এবং এই যুক্তি দিয়ে সক্ষম করা যেতে পারে।

ANDROID_NATIVE_API_LEVEL

ANDROID_PLATFORM এর উপনাম।

ANDROID_PLATFORM

অ্যাপ্লিকেশন বা লাইব্রেরি দ্বারা সমর্থিত ন্যূনতম API স্তর নির্দিষ্ট করে৷ এই মানটি অ্যাপ্লিকেশনের minSdkVersion এর সাথে মিলে যায়।

এই প্যারামিটারের জন্য একাধিক বিন্যাস গ্রহণ করা হয়:

• android-$API_LEVEL
• $API_LEVEL
• android-$API_LETTER

$API_LETTER ফর্ম্যাট আপনাকে সেই রিলিজের সাথে যুক্ত নম্বর নির্ধারণ করার প্রয়োজন ছাড়াই android-N নির্দিষ্ট করতে দেয়। নোট করুন যে কিছু রিলিজ একটি অক্ষর বৃদ্ধি ছাড়া একটি API বৃদ্ধি পেয়েছে। এই APIগুলিকে -MR1 প্রত্যয় যুক্ত করে নির্দিষ্ট করা যেতে পারে। উদাহরণস্বরূপ, API স্তর 25 হল android-N-MR1 ।

ANDROID_STL

এই অ্যাপ্লিকেশনের জন্য কোন STL ব্যবহার করতে হবে তা নির্দিষ্ট করে। আরও তথ্যের জন্য, C++ লাইব্রেরি সমর্থন দেখুন। ডিফল্টরূপে, c++_static ব্যবহার করা হবে।

CMake বিল্ড কমান্ড বুঝুন

CMake বিল্ড সমস্যাগুলি ডিবাগ করার সময়, Android এর জন্য ক্রস-কম্পাইল করার সময় Gradle যে নির্দিষ্ট বিল্ড আর্গুমেন্টগুলি ব্যবহার করে তা জানার জন্য এটি সহায়ক।

অ্যান্ড্রয়েড গ্রেডল প্লাগইন বিল্ড আর্গুমেন্টগুলি সংরক্ষণ করে যা এটি প্রতিটি ABI-এর জন্য একটি CMake বিল্ড কার্যকর করার জন্য ব্যবহার করে এবং build_command.txt এ বিল্ড টাইপ জোড়া। এই ফাইলগুলি নিম্নলিখিত ডিরেক্টরিতে পাওয়া যায়:

<project-root>/<module-root>/.cxx/cmake/<build-type>/<ABI>/

নিচের স্নিপেটটি armeabi-v7a আর্কিটেকচারকে লক্ষ্য করে hello-jni নমুনার একটি ডিবাগযোগ্য রিলিজ তৈরি করতে CMake আর্গুমেন্টের একটি উদাহরণ দেখায়।

                    Executable : ${HOME}/Android/Sdk/cmake/3.10.2.4988404/bin/cmake
arguments :
-H${HOME}/Dev/github-projects/googlesamples/ndk-samples/hello-jni/app/src/main/cpp
-DCMAKE_FIND_ROOT_PATH=${HOME}/Dev/github-projects/googlesamples/ndk-samples/hello-jni/app/.cxx/cmake/universalDebug/prefab/armeabi-v7a/prefab
-DCMAKE_BUILD_TYPE=Debug
-DCMAKE_TOOLCHAIN_FILE=${HOME}/Android/Sdk/ndk/22.1.7171670/build/cmake/android.toolchain.cmake
-DANDROID_ABI=armeabi-v7a
-DANDROID_NDK=${HOME}/Android/Sdk/ndk/22.1.7171670
-DANDROID_PLATFORM=android-23
-DCMAKE_ANDROID_ARCH_ABI=armeabi-v7a
-DCMAKE_ANDROID_NDK=${HOME}/Android/Sdk/ndk/22.1.7171670
-DCMAKE_EXPORT_COMPILE_COMMANDS=ON
-DCMAKE_LIBRARY_OUTPUT_DIRECTORY=${HOME}/Dev/github-projects/googlesamples/ndk-samples/hello-jni/app/build/intermediates/cmake/universalDebug/obj/armeabi-v7a
-DCMAKE_RUNTIME_OUTPUT_DIRECTORY=${HOME}/Dev/github-projects/googlesamples/ndk-samples/hello-jni/app/build/intermediates/cmake/universalDebug/obj/armeabi-v7a
-DCMAKE_MAKE_PROGRAM=${HOME}/Android/Sdk/cmake/3.10.2.4988404/bin/ninja
-DCMAKE_SYSTEM_NAME=Android
-DCMAKE_SYSTEM_VERSION=23
-B${HOME}/Dev/github-projects/googlesamples/ndk-samples/hello-jni/app/.cxx/cmake/universalDebug/armeabi-v7a
-GNinja
jvmArgs :


                    Build command args: []
                    Version: 1

প্রি-বিল্ট লাইব্রেরি ব্যবহার করুন

যদি পূর্বনির্মাণ করা লাইব্রেরিটি আপনাকে আমদানি করতে হবে তা AAR হিসাবে বিতরণ করা হয়, সেগুলি আমদানি করতে এবং ব্যবহার করতে স্টুডিওর নির্ভরতা ডক্স অনুসরণ করুন৷ আপনি যদি AGP ব্যবহার না করেন তাহলে আপনি https://google.github.io/prefab/example-workflow.html অনুসরণ করতে পারেন, তবে সম্ভবত AGP-এ স্থানান্তর করা অনেক সহজ।

লাইব্রেরিগুলির জন্য যেগুলি AAR হিসাবে বিতরণ করা হয় না, CMake-এর সাথে প্রি-বিল্ট লাইব্রেরিগুলি ব্যবহার করার নির্দেশাবলী, CMake ম্যানুয়াল -এ IMPORTED লক্ষ্য সংক্রান্ত add_library ডকুমেন্টেশন দেখুন।

বিল্ডিং তৃতীয় পক্ষের কোড

আপনার CMake প্রকল্পের অংশ হিসাবে তৃতীয়-পক্ষের কোড তৈরি করার কয়েকটি উপায় রয়েছে এবং কোন বিকল্পটি সবচেয়ে ভাল কাজ করে তা আপনার পরিস্থিতির উপর নির্ভর করবে। সর্বোত্তম বিকল্পটি প্রায়শই এটি না করাই হবে। পরিবর্তে, লাইব্রেরির জন্য একটি AAR তৈরি করুন এবং আপনার অ্যাপ্লিকেশনে এটি ব্যবহার করুন। আপনার অগত্যা সেই AAR প্রকাশ করার দরকার নেই। এটি আপনার গ্রেডল প্রকল্পের অভ্যন্তরীণ হতে পারে।

যদি এটি একটি বিকল্প না হয়:

• বিক্রেতা (অর্থাৎ অনুলিপি) আপনার সংগ্রহস্থলে তৃতীয় পক্ষের উত্স এবং এটি তৈরি করতে add_subdirectory ব্যবহার করুন। এটি শুধুমাত্র তখনই কাজ করে যদি অন্য লাইব্রেরিটিও CMake দিয়ে তৈরি করা হয়।
• একটি বহিরাগত প্রকল্প সংজ্ঞায়িত করুন।
• আপনার প্রকল্প থেকে আলাদাভাবে লাইব্রেরি তৈরি করুন এবং এটিকে পূর্বনির্মাণ হিসাবে আমদানি করতে পূর্বনির্মাণ লাইব্রেরি ব্যবহার করুন অনুসরণ করুন।

CMake এ YASM সমর্থন

NDK x86 এবং x86-64 আর্কিটেকচারে চালানোর জন্য YASM- এ লিখিত সমাবেশ কোড নির্মাণের জন্য CMake সমর্থন প্রদান করে। YASM হল NASM অ্যাসেম্বলারের উপর ভিত্তি করে x86 এবং x86-64 আর্কিটেকচারের জন্য একটি ওপেন-সোর্স অ্যাসেম্বলার।

CMake এর সাথে সমাবেশ কোড তৈরি করতে, আপনার প্রকল্পের CMakeLists.txt এ নিম্নলিখিত পরিবর্তনগুলি করুন:

1. ASM_NASM তে সেট মান সহ enable_language কল করুন।
2. আপনি একটি শেয়ার্ড লাইব্রেরি বা এক্সিকিউটেবল বাইনারি তৈরি করছেন তার উপর নির্ভর করে, add_library বা add_executable কল করুন। আর্গুমেন্টে, YASM-এ এসেম্বলি প্রোগ্রামের জন্য .asm ফাইল এবং সংশ্লিষ্ট C লাইব্রেরি বা ফাংশনের জন্য .c ফাইল সমন্বিত সোর্স ফাইলগুলির একটি তালিকা পাস করুন।

নিচের স্নিপেটটি দেখায় কিভাবে আপনি একটি শেয়ার্ড লাইব্রেরি হিসাবে একটি YASM প্রোগ্রাম তৈরি করতে আপনার CMakeLists.txt কনফিগার করতে পারেন।

cmake_minimum_required(VERSION 3.6.0)

enable_language(ASM_NASM)

add_library(test-yasm SHARED jni/test-yasm.c jni/print_hello.asm)

এক্সিকিউটেবল হিসাবে একটি YASM প্রোগ্রাম কীভাবে তৈরি করা যায় তার উদাহরণের জন্য, NDK গিট সংগ্রহস্থলে ইয়াসম পরীক্ষা দেখুন।

সমস্যা রিপোর্ট করুন

আপনি যদি NDK বা এর CMake টুলচেন ফাইলের সাথে কোনো সমস্যায় পড়েন, GitHub-এ android-ndk/ndk ইস্যু ট্র্যাকারের মাধ্যমে রিপোর্ট করুন। Gradle বা Android Gradle Plugin সমস্যাগুলির জন্য, পরিবর্তে একটি স্টুডিও বাগ রিপোর্ট করুন ।