আপনার প্রোজেক্ট মডিউলের cpp ডিরেক্টরিতে কোডটি রেখে আপনার Android প্রোজেক্টে C এবং C++ কোড যোগ করুন। আপনার প্রোজেক্ট তৈরি করার সময়, এই
কোডটি একটি নেটিভ লাইব্রেরিতে কম্পাইল করা হয় যা Gradle আপনার অ্যাপের সাথে প্যাকেজ করতে পারে।
আপনার Java বা Kotlin কোড তারপর Java Native Interface (JNI)-এর মাধ্যমে
আপনার নেটিভ লাইব্রেরিতে ফাংশন কল করতে পারে। JNI ফ্রেমওয়ার্ক ব্যবহার করার ব্যাপারে আরও জানতে,
Android-এর জন্য JNI সংক্রান্ত পরামর্শ
পড়ুন।
Android Studio-তে CMake কাজ করে, যা ক্রস-প্ল্যাটফর্ম প্রোজেক্টের জন্য উপযোগী।
Android Studio-তে ndk-build-ও কাজ করে, যা
CMake-এর চেয়ে দ্রুত হতে পারে, তবে এটি শুধু Android-এ কাজ করে। একই মডিউলে CMake এবং
ndk-build দুটিই ব্যবহার করার সুবিধা বর্তমানে উপলভ্য নেই।
আপনার Android Studio প্রোজেক্টে আগে থেকে থাকা ndk-build লাইব্রেরি ইমপোর্ট করতে,
আপনার নেটিভ লাইব্রেরি প্রোজেক্টে Gradle কীভাবে লিঙ্ক করবেন তা জানুন।
এই পৃষ্ঠা থেকে আপনি জানতে পারবেন কীভাবে প্রয়োজনীয় বিল্ড টুলের সাহায্যে Android Studio সেট-আপ করতে হয়, C/C++ সাপোর্ট সহ নতুন প্রোজেক্ট তৈরি করতে হয় এবং আপনার প্রোজেক্টে নতুন C/C++ ফাইল যোগ করতে হয়।
পরিবর্তে, আপনি যদি আগে থেকে থাকা কোনও প্রোজেক্টে নেটিভ কোড যোগ করতে চান, তাহলে এইসব ধাপ অনুসরণ করুন:
-
নতুন নেটিভ সোর্স ফাইল তৈরি করুন এবং আপনার Android Studio প্রোজেক্টে
ফাইল যোগ করুন।
- আপনার কাছে আগে থেকেই নেটিভ কোড থাকলে অথবা আগে থেকে তৈরি নেটিভ লাইব্রেরি ইমপোর্ট করতে চাইলে এই ধাপটি এড়িয়ে যান।
-
আপনার নেটিভ সোর্স কোডকে লাইব্রেরিতে বিল্ড করতে
CMake কনফিগার করুন। আপনি যদি প্রি-বিল্ট বা প্ল্যাটফর্ম লাইব্রেরির সাথে ইমপোর্ট এবং লিঙ্ক করেন,
তাহলে এই বিল্ড স্ক্রিপ্ট
প্রয়োজন।
- আপনার কাছে আগে থেকে কোনও নেটিভ লাইব্রেরি থাকলে, যাতে আগে থেকেই
CMakeLists.txtবিল্ড স্ক্রিপ্ট আছে অথবাndk-buildব্যবহার করে এবং একটিAndroid.mkবিল্ড স্ক্রিপ্ট অন্তর্ভুক্ত করে, তাহলে এই ধাপটি এড়িয়ে যান।
- আপনার কাছে আগে থেকে কোনও নেটিভ লাইব্রেরি থাকলে, যাতে আগে থেকেই
-
আপনার CMake বা
ndk-buildস্ক্রিপ্ট ফাইলের পাথ প্রদান করে Gradle কনফিগার করুন। Gradle আপনার Android Studio প্রোজেক্টে সোর্স কোড ইমপোর্ট করতে এবং অ্যাপে আপনার নেটিভ লাইব্রেরি প্যাকেজ করতে বিল্ড স্ক্রিপ্ট ব্যবহার করে।
আপনার প্রোজেক্ট কনফিগার করার পরে, JNI ফ্রেমওয়ার্ক ব্যবহার করে Java বা Kotlin কোড থেকে
আপনার নেটিভ ফাংশন অ্যাক্সেস করুন। আপনার অ্যাপ তৈরি করতে ও চালাতে,
রান করুন
বিকল্পে ক্লিক করুন।
মনে রাখবেন: আপনার আগে থেকে থাকা প্রোজেক্ট যদি বন্ধ হয়ে যাওয়া
ndkCompile টুল ব্যবহার করে, তাহলে CMake বা
ndk-build-এ মাইগ্রেট করুন।
NDK ও বিল্ড টুল ডাউনলোড করুন
আপনার অ্যাপের জন্য নেটিভ কোড কম্পাইল ও ডিবাগ করতে, আপনার নিম্নলিখিত কম্পোনেন্টগুলি প্রয়োজন:
- Android Native Development Kit (NDK): একটি টুলসেট যা আপনাকে Android-এর সাথে C এবং C++ কোড ব্যবহার করতে দেয়। NDK প্ল্যাটফর্ম লাইব্রেরি প্রদান করে যা আপনাকে নেটিভ অ্যাক্টিভিটি ম্যানেজ করতে এবং সেন্সর ও টাচ ইনপুটের মতো ফিজিক্যাল ডিভাইসের কম্পোনেন্ট অ্যাক্সেস করতে দেয়।
-
CMake: একটি
এক্সটার্নাল বিল্ড টুল যা আপনার নেটিভ লাইব্রেরি তৈরি করতে Gradle-এর সাথে
কাজ করে। আপনি শুধু
ndk-buildব্যবহার করার পরিকল্পনা করলে, এই কম্পোনেন্ট আপনার প্রয়োজন নেই। - LLDB: Android Studio-তে ডিবাগার যা নেটিভ কোড ডিবাগ করে।
এইসব কম্পোনেন্ট ইনস্টল করার ব্যাপারে তথ্যের জন্য, NDK ও CMake ইনস্টল ও কনফিগার করুন দেখুন।
C/C++ সাপোর্ট সহ নতুন প্রোজেক্ট তৈরি করা
নেটিভ কোডের জন্য সাপোর্ট সহ নতুন প্রোজেক্ট তৈরি করার প্রসেসটি অন্য যেকোনও Android Studio প্রোজেক্ট তৈরি করার মতোই, তবে এতে একটি অতিরিক্ত ধাপ রয়েছে:
- উইজার্ডের আপনার প্রোজেক্ট বেছে নিন বিভাগে, নেটিভ C++ প্রোজেক্টের ধরন বেছে নিন।
- পরবর্তী বিকল্পে ক্লিক করুন।
- উইজার্ডের পরবর্তী বিভাগে অন্যান্য সব ফিল্ড পূরণ করুন।
- পরবর্তী বিকল্পে ক্লিক করুন।
-
উইজার্ডের C++ সাপোর্ট কাস্টমাইজ করুন বিভাগে, আপনি C++ স্ট্যান্ডার্ড ফিল্ডের সাহায্যে
আপনার প্রোজেক্ট কাস্টমাইজ করতে পারবেন।
- ড্রপ-ডাউন তালিকা ব্যবহার করে C++-এর কোন স্ট্যান্ডার্ডাইজেশন ব্যবহার করতে চান তা বেছে নিন। টুলচেন ডিফল্ট বেছে নিলে ডিফল্ট CMake সেটিং ব্যবহার করা হয়।
- সম্পূর্ণ করুন বিকল্পে ক্লিক করুন।
Android Studio আপনার নতুন প্রোজেক্ট তৈরি করা শেষ করার পরে, IDE-এর বাঁদিক থেকে প্রোজেক্ট প্যানেল খুলুন এবং মেনু থেকে Android ভিউ বেছে নিন। ছবি ১-এ যেমন দেখানো হয়েছে, Android Studio cpp গ্রুপ যোগ করে:
ছবি ১. আপনার নেটিভ সোর্স এবং এক্সটার্নাল বিল্ড স্ক্রিপ্টের জন্য Android ভিউ গ্রুপ।
মনে রাখবেন: এই ভিউ ডিস্কে ফাইলের প্রকৃত হায়ারার্কি দেখায় না, তবে আপনার প্রোজেক্টে নেভিগেট করা সহজ করতে একই ধরনের ফাইল গ্রুপ করে।
cpp গ্রুপে আপনি সব নেটিভ সোর্স ফাইল, হেডার, CMake বা ndk-build-এর জন্য বিল্ড স্ক্রিপ্ট এবং আপনার প্রোজেক্টের অংশ হিসেবে আগে থেকে তৈরি লাইব্রেরি খুঁজে পাবেন। নতুন প্রোজেক্টের জন্য, Android Studio
একটি স্যাম্পেল C++ সোর্স ফাইল, native-lib.cpp তৈরি করে এবং এটি
আপনার অ্যাপ মডিউলের src/main/cpp/ ডিরেক্টরিতে রাখে। এই স্যাম্পেল
কোড একটি সহজ C++ ফাংশন, stringFromJNI() প্রদান করে, যা
"Hello from C++" স্ট্রিং রিটার্ন করে। নতুন নেটিভ সোর্স ফাইল তৈরি করুন
বিভাগে গিয়ে আপনার প্রোজেক্টে কীভাবে অতিরিক্ত
সোর্স ফাইল যোগ করবেন তা জানুন।
build.gradle ফাইল যেভাবে Gradle-কে আপনার অ্যাপ তৈরি করার নির্দেশ দেয়, ঠিক একইভাবে CMake এবং ndk-build-এর জন্য আপনার নেটিভ লাইব্রেরি কীভাবে তৈরি করতে হবে তা জানার জন্য
একটি বিল্ড স্ক্রিপ্ট প্রয়োজন। নতুন প্রোজেক্টের জন্য, Android Studio একটি CMake বিল্ড
স্ক্রিপ্ট,CMakeLists.txt তৈরি করে এবং আপনার মডিউলের রুট ডিরেক্টরিতে এটি রাখে।
এই বিল্ড স্ক্রিপ্টের কন্টেন্ট সম্পর্কে আরও জানতে,
CMake কনফিগার করুন পড়ুন।
স্যাম্পেল অ্যাপ তৈরি ও রান করা
আপনি রান করুন
বিকল্পে ক্লিক করলে, Android Studio
একটি অ্যাপ তৈরি ও লঞ্চ করে যা আপনার Android ডিভাইস বা এমুলেটরে "C++ থেকে হ্যালো" টেক্সট দেখায়। স্যাম্পেল অ্যাপ তৈরি ও রান করার সময় যেসব ইভেন্ট
ঘটে, নিম্নলিখিত ওভারভিউতে সেগুলি বর্ণনা করা হয়েছে:
- আপনার এক্সটার্নাল বিল্ড স্ক্রিপ্টে Gradle কল,
CMakeLists.txt. - CMake, C++ সোর্স ফাইল,
native-lib.cpp, শেয়ার করা অবজেক্ট লাইব্রেরিতে কম্পাইল করতে বিল্ড স্ক্রিপ্টের কমান্ড অনুসরণ করে এবং এটির নামlibnative-lib.soদেয়। তারপর Gradle এটিকে অ্যাপে প্যাকেজ করে। - রানটাইমের সময়, অ্যাপের
MainActivitySystem.loadLibrary()ব্যবহার করে নেটিভ লাইব্রেরি লোড করে। লাইব্রেরির নেটিভ ফাংশন,stringFromJNI(), এখন অ্যাপে উপলভ্য। -
MainActivity.onCreate()stringFromJNI()-কে কল করে, যা"Hello from C++"রিটার্ন করে এবংTextViewআপডেট করতে এটি ব্যবহার করে।
Gradle অ্যাপে নেটিভ লাইব্রেরি প্যাকেজ করে কিনা তা যাচাই করতে, APK Analyzer ব্যবহার করুন:
- বিল্ড করুন > বান্ডেল / APK বিল্ড করুন > APK বিল্ড করুন বিকল্প বেছে নিন।
- বিল্ড করুন > APK বিশ্লেষণ করুন বিকল্প বেছে নিন।
app/build/outputs/ডিরেক্টরি থেকে APK বা AAB বেছে নিন এবং ঠিক আছে বিকল্পে ক্লিক করুন।- ছবি ২-এ যেমন দেখানো হয়েছে, আপনি
lib/<ABI>/-এর অধীনে APK Analyzer উইন্ডোতেlibnative-lib.soদেখতে পাবেন।
ছবি ২. APK Analyzer ব্যবহার করে নেটিভ লাইব্রেরি খুঁজে নিন।
পরামর্শ: আপনি যদি নেটিভ কোড ব্যবহার করে এমন অন্যান্য Android অ্যাপ নিয়ে পরীক্ষা করতে চান, তাহলে File > New > Import Sample বিকল্পে ক্লিক করুন এবং Ndk তালিকা থেকে একটি স্যাম্পেল প্রোজেক্ট বেছে নিন।
নতুন C/C++ সোর্স ফাইল তৈরি করুন
আগে থেকে থাকা প্রোজেক্টে নতুন C/C++ সোর্স ফাইল যোগ করতে, নিম্নলিখিত ধাপগুলি অনুসরণ করুন:
- আপনার অ্যাপের মূল সোর্স সেটে আগে থেকে
cpp/ডিরেক্টরি না থাকলে, নিম্নলিখিত উপায়ে একটি তৈরি করুন: - IDE-এর বাঁদিকে প্রোজেক্ট প্যানেল খুলুন এবং মেনু থেকে প্রোজেক্ট ভিউ বেছে নিন।
- your-module > src-এ নেভিগেট করুন।
- প্রধান ডিরেক্টরির উপর ডানদিকের মাউস বোতামে ক্লিক করুন এবং নতুন > ডিরেক্টরি বিকল্প বেছে নিন।
- ডিরেক্টরির নাম হিসেবে
cppলিখুন এবং ঠিক আছে বিকল্পে ক্লিক করুন। cpp/ডিরেক্টরিতে ডানদিকের বোতামে ক্লিক করে নতুন > C/C++ সোর্স ফাইল বিকল্প বেছে নিন।- আপনার সোর্স ফাইলের নাম লিখুন, যেমন
native-lib। - ধরন মেনু থেকে, আপনার সোর্স ফাইলের জন্য ফাইল এক্সটেনশন
বেছে নিন, যেমন
.cpp।- মেনুতে অন্যান্য ফাইলের ধরন যোগ করতে, ফাইলের ধরন এডিট করুন
বিকল্পে ক্লিক করুন, যেমন
.cxxবা.hxx। পপ-আপ হওয়া নতুন ফাইল এক্সটেনশন ডায়ালগ বক্সে, সোর্স এক্সটেনশন এবং হেডার এক্সটেনশন মেনু থেকে অন্য একটি ফাইল এক্সটেনশন বেছে নিন এবং ঠিক আছে বিকল্পে ক্লিক করুন।
- মেনুতে অন্যান্য ফাইলের ধরন যোগ করতে, ফাইলের ধরন এডিট করুন
- হেডার ফাইল তৈরি করতে, সংশ্লিষ্ট হেডার তৈরি করুন চেকবক্স বেছে নিন।
- ঠিক আছে বিকল্পে ক্লিক করুন।
আপনার প্রোজেক্টে নতুন C/C++ ফাইল যোগ করার পরেও, আপনার নেটিভ লাইব্রেরিতে ফাইলগুলি অন্তর্ভুক্ত করার জন্য আপনাকে CMake কনফিগার করতে হবে।