এই টিউটোরিয়াল আপনাকে প্রথমবার Android অপারেটিং সিস্টেম ডেভেলপমেন্ট ব্যবহার করে দেখার সুযোগ করে দেয়।
Android ডেভেলপমেন্টের জন্য সেট-আপ করা
Android সোর্সের android-latest-release ম্যানিফেস্ট ব্রাঞ্চ ডাউনলোড ও তৈরি করার আগে, আপনার হার্ডওয়্যার প্রয়োজনীয় শর্ত পূরণ করছে কিনা এবং প্রয়োজনীয় সফ্টওয়্যার
সঠিকভাবে ইনস্টল করা আছে কিনা তা নিশ্চিত করুন। এছাড়াও, আপনাকে নিম্নলিখিত শব্দগুলি সম্পর্কে জানতে হবে:
- Git
- Git হল একটি ফ্রি এবং ওপেন সোর্স ডিস্ট্রিবিউটেড ভার্সন কন্ট্রোল সিস্টেম। Android, লোকাল অপারেশনের জন্য Git ব্যবহার করে, যেমন ব্রাঞ্চিং, কমিট, ডিফারেন্স ও এডিট। Git শেখার ব্যাপারে সাহায্য পেতে, Git ডকুমেন্টেশন দেখুন।
- Repo
- Repo হল Git-এর চারপাশে একটি Python র্যাপার যা একাধিক Git রিপোজিটরি জুড়ে জটিল অপারেশন সম্পাদন করা সহজ করে তোলে। Repo সব ভার্সন কন্ট্রোল অপারেশনের জন্য Git-কে রিপ্লেস করে না; এটি শুধু জটিল Git অপারেশনকে সহজে সম্পন্ন করতে সাহায্য করে। Repo, Git প্রোজেক্টকে Android সুপারপ্রোজেক্টে একত্রিত করতে ম্যানিফেস্ট ফাইল ব্যবহার করে।
- ম্যানিফেস্ট ফাইল
- ম্যানিফেস্ট ফাইল হল একটি XML ফাইল যা Android সোর্সের বিভিন্ন Git প্রোজেক্ট AOSP সোর্স ট্রির মধ্যে কোথায় আছে তা নির্দিষ্ট করে।
Meet হার্ডওয়্যার সংক্রান্ত প্রয়োজনীয়তা
আপনার ডেভেলপমেন্ট ওয়ার্কস্টেশনে এইসব হার্ডওয়্যার সংক্রান্ত প্রয়োজনীয়তা পূরণ করতে হবে বা তার চেয়ে বেশি হতে হবে:
একটি 64-বিট x86 সিস্টেম।
কোড চেক আউট ও বিল্ড করার জন্য ডিস্কে অন্তত ৪০০ জিবি খালি জায়গা থাকতে হবে (চেক আউটের জন্য ২৫০ জিবি + বিল্ড করার জন্য ১৫০ জিবি)।
কমপক্ষে ৬৪ জিবি র্যাম। Android তৈরি করতে Google ৬৪ জিবি RAM সহ ৭২-কোর মেশিন ব্যবহার করে। এই হার্ডওয়্যার কনফিগারেশনের মাধ্যমে, Android-এর সম্পূর্ণ বিল্ডের জন্য প্রায় ৪০ মিনিট এবং Android-এর ইনক্রিমেন্টাল বিল্ডের জন্য মাত্র কয়েক মিনিট সময় লাগে। এর বিপরীতে, ৬৪ জিবি RAM সহ ৬-কোর মেশিনের সাহায্যে সম্পূর্ণ বিল্ড করতে প্রায় ৬ ঘণ্টা সময় লাগে।
অপারেটিং সিস্টেম সংক্রান্ত প্রয়োজনীয়তা পূরণ করা
আপনার ডেভেলপমেন্ট ওয়ার্কস্টেশনে GNU C Library (glibc) ২.১৭ বা তার পরবর্তী ভার্সন সহ যেকোনও ৬৪-বিট Linux ডিস্ট্রিবিউশন রান করতে হবে।
প্রয়োজনীয় প্যাকেজ ইনস্টল করুন
Ubuntu 18.04 বা তার পরবর্তী ভার্সনের জন্য প্রয়োজনীয় প্যাকেজ ইনস্টল করতে, নিম্নলিখিত কমান্ড রান করুন:
sudo apt-get install git-core gnupg flex bison build-essential zip curl zlib1g-dev libc6-dev-i386 x11proto-core-dev libx11-dev lib32z1-dev libgl1-mesa-dev libxml2-utils xsltproc unzip fontconfigপ্রয়োজনীয় সফ্টওয়্যার ইনস্টল করুন
AOSP-এর সাথে কাজ করার আগে, আপনাকে OpenJDK, Make, Python 3 ও Repo ইনস্টল করতে হবে। Android-এর লেটেস্ট রিলিজ ব্রাঞ্চে OpenJDK, Make ও Python 3-এর প্রি-বিল্ট ভার্সন থাকে, তাই অতিরিক্ত ইনস্টলেশন ধাপের প্রয়োজন হয় না। Repo কীভাবে ইনস্টল করতে হয় তা নিম্নলিখিত বিভাগে ব্যাখ্যা করা হয়েছে।
Repo ইনস্টল করুন
Repo ইনস্টল করতে এইসব ধাপ অনুসরণ করুন:
বর্তমান প্যাকেজের তথ্য ডাউনলোড করুন:
sudo apt-get updateRepo লঞ্চার ইনস্টল করতে এই কমান্ড রান করুন:
sudo apt-get install repoRepo লঞ্চার একটি Python স্ক্রিপ্ট প্রদান করে যা একটি চেকআউট শুরু করে এবং সম্পূর্ণ Repo টুল ডাউনলোড করে।
হয়ে গেলে, ধাপ ৪-এ যান।
ঐচ্ছিক: নিম্নলিখিত কমান্ডের সিরিজ ব্যবহার করে ম্যানুয়ালি Repo ইনস্টল করুন:
export REPO=$(mktemp /tmp/repo.XXXXXXXXX)curl -o ${REPO} https://storage.googleapis.com/git-repo-downloads/repogpg --recv-keys 8BB9AD793E8E6153AF0F9A4416530D5E920F5C65curl -s https://storage.googleapis.com/git-repo-downloads/repo.asc | gpg --verify - ${REPO} && install -m 755 ${REPO} ~/bin/repoপ্রথম তিনটি কমান্ড একটি টেম্প ফাইল সেট-আপ করে, ফাইলে Repo ডাউনলোড করে এবং প্রদান করা কী প্রয়োজনীয় কী-এর সাথে মিলছে কিনা তা যাচাই করে। এই কমান্ডগুলি সফল হলে, চূড়ান্ত কমান্ড Repo লঞ্চার ইনস্টল করে।
Repo লঞ্চার ভার্সন যাচাই করুন:
repo versionআউটপুটে ২.৪ বা তার পরের যেকোনও ভার্সন দেখাতে হবে, যেমন:
repo launcher version 2.45
Android সোর্স ডাউনলোড করুন
Android সোর্স, Google-এর হোস্ট করা Git রিপোজিটরির সংগ্রহে রয়েছে। প্রতিটি Git রিপোজিটরিতে Android সোর্সের সম্পূর্ণ ইতিহাস অন্তর্ভুক্ত থাকে, যার মধ্যে সোর্সে করা পরিবর্তন এবং কখন পরিবর্তন করা হয়েছে তা অন্তর্ভুক্ত থাকে। Android সোর্স ডাউনলোড করতে:
আপনার হোম ডিরেক্টরিতে নেভিগেট করুন:
cd ~এর মধ্যে একটি লোকাল ওয়ার্কিং সাবডিরেক্টরি তৈরি করুন:
mkdir aospডিরেক্টরিতে নেভিগেট করুন:
cd aospAOSP রিপোজিটরি সোর্স কোডের লেটেস্ট রিলিজ ব্রাঞ্চ ইনিশিয়ালাইজ করুন (
android-latest-release):repo init --partial-clone -b android-latest-release -u https://android.googlesource.com/platform/manifestআপনার Git ক্রেডেনশিয়াল (নাম, ইমেল আইডি) লিখুন বা গ্রহণ করুন।
সোর্স কোড সিঙ্ক করুন:
repo sync -c -j8ডাউনলোড করার সময় কোনও সমস্যা হলে, সিঙ্ক সংক্রান্ত সমস্যার সমাধান করুন লিঙ্কটি দেখুন।
কোড তৈরি করুন
কোড তৈরি করতে:
আপনার ওয়ার্কিং ডিরেক্টরি থেকে, বিল্ড এনভায়রনমেন্ট সেট-আপ করতে
envsetup.shস্ক্রিপ্ট সোর্স করুন:source build/envsetup.shlunchকমান্ডের সাহায্যে তৈরি করার জন্য টার্গেট ডিভাইসের ধরন উল্লেখ করুন। টার্গেট হল ডিভাইসের পারমুটেশন, যেমন নির্দিষ্ট মডেল বা ফর্ম ফ্যাক্টর। এই টার্গেট নির্দিষ্ট করুন:lunch aosp_cf_x86_64_only_phone-aosp_current-userdebugআপনার টার্গেট ও বিল্ড এনভায়রনমেন্টের সারসংক্ষেপ দেখতে পাবেন:
============================================ PLATFORM_VERSION_CODENAME=Baklava PLATFORM_VERSION=Baklava TARGET_PRODUCT=aosp_cf_x86_64_only_phone TARGET_BUILD_VARIANT=userdebug TARGET_ARCH=x86_64 TARGET_ARCH_VARIANT=silvermont HOST_OS=linux HOST_OS_EXTRA=Linux-6.10.11-1rodete2-amd64-x86_64-Debian-GNU/Linux-rodete HOST_CROSS_OS=windows BUILD_ID=BP1A.250305.020 OUT_DIR=out ============================================টার্গেট তৈরি করুন:
m
প্রথম বিল্ড তৈরি হতে কয়েক ঘণ্টা সময় লাগতে পারে। পরবর্তী বিল্ডগুলি উল্লেখযোগ্যভাবে কম সময়
নেয়। আপনার বিল্ডের আউটপুট $OUT_DIR-এ দেখা যাবে।
Cuttlefish লঞ্চ করুন
Cuttlefish হল Android এমুলেটর যা আপনার বিল্ড পরীক্ষা করতে ব্যবহার করা হয়।
হোস্ট Debian প্যাকেজ ডাউনলোড, তৈরি ও ইনস্টল করতে নিম্নলিখিত কমান্ডগুলি রান করুন:
sudo apt install -y git devscripts equivs config-package-dev debhelper-compat golang curlgit clone https://github.com/google/android-cuttlefishcd android-cuttlefishtools/buildutils/build_packages.shsudo apt install -y ./cuttlefish-base_*.deb ./cuttlefish-user_*.debsudo usermod -aG kvm,cvdnetwork,render $USERsudo rebootরিবুট করার ফলে অতিরিক্ত কার্নেল মডিউল ইনস্টল হয় এবং
udevনিয়ম প্রযোজ্য হয়।আপনার ওয়ার্কস্টেশন রিবুট করার পরে, আপনার
aospডিরেক্টরিতে নেভিগেট করুন, আপনার বিল্ড এনভায়রনমেন্ট সেট-আপ করুন এবং Cuttlefish লঞ্চ করুন:cd ~/aospsource build/envsetup.shlunch aosp_cf_x86_64_only_phone-aosp_current-userdebuglaunch_cvd --daemonআপনার ওয়েব ব্রাউজারে
https://localhost:8443-এ নেভিগেট করে Cuttlefish ডিভাইসে কানেক্ট করুন। আপনার ভার্চুয়াল Android-চালিত ডিভাইস দেখানো হয়েছে।
কোনও পরিবর্তন করুন
এই উদাহরণ পরিবর্তনের তালিকা অনুসরণ করে সোর্স কোড আপডেট করুন।
আপনার চেকআউটের রুট (
aosp/ডিরেক্টরি) থেকে,frameworks/nativeGit প্রোজেক্টে নেভিগেট করুন:cd frameworks/nativeএই কমান্ডের সাহায্যে একটি সাময়িক ব্রাঞ্চ শুরু করুন:
repo start BRANCH_NAME .নিম্নলিখিত লোকেশনে
SurfaceFlinger.cppএডিট করতে আপনার এডিটর ব্যবহার করুন:aosp/frameworks/native/services/surfaceflinger/SurfaceFlinger.cppএই লাইনটি খুঁজুন:
void SurfaceFlinger::updateColorMatrixLocked() {updateColorMatrixLocked()-এর শুরুতে এই লাইন যোগ করুন:mClientColorMatrix = mat4(vec4{1.0f, 0.0f, 0.0f, 0.0f}, vec4{0.0f, -1.0f, 0.0f, 0.0f}, vec4{0.0f, 0.0f, -1.0f, 0.0f}, vec4{0.0f, 1.0f, 1.0f, 1.0f});কোড তৈরি করুন:
mডিভাইসে বিল্ড আপডেট করুন:
adb rootadb remount -Radb rootadb syncadb rebootআপনার বেছে নেওয়া ডিভাইসে রঙের পরিবর্তন দেখতে পাচ্ছেন কিনা তা যাচাই করুন।
কোনও টেস্ট ঠিক করা
কোডল্যাবের এই অংশটি সোর্স ট্রিতে থাকা একটি উদাহরণ টেস্ট ব্যবহার করে এবং এটি ব্যর্থ হচ্ছে। টেস্ট রান, ডিবাগ ও সমাধান করতে, এই নির্দেশাবলী অনুসরণ করুন:
রান করুন:
atest DevCodelabTestটেস্ট করা যায়নি।
ব্যর্থ হওয়া টেস্টের স্ট্যাক ট্রেস পরীক্ষা করুন:
STACKTRACE: java.lang.AssertionError at org.junit.Assert.fail(Assert.java:87) at org.junit.Assert.assertTrue(Assert.java:42) at org.junit.Assert.assertTrue(Assert.java:53) at android.test.example.devcodelab.DevCodelabTest.testHelloWorld(DevCodelabTest.java:29)স্ট্যাক ট্রেসের শেষ লাইনে সেই টেস্ট দেখানো হয় যেটি ব্যর্থ হচ্ছে (
testHelloWorld)। এই টেস্টDevCodelabTest.javaনামের ফাইলে আছে।যে টেস্টটি ঠিক করতে হবে তার লোকেশন নির্ধারণ করতে, টেস্ট ফাইলের নাম সহ স্ট্যাক ট্রেসের শেষ লাইনে
WORKING_DIRECTORY/platform_testing/tests/example/devcodelab/src/যোগ করুন। তাই,android.test.example.devcodelab.DevCodelabTestহয়ে যায়WORKING_DIRECTORY/platform_testing/tests/example/devcodelab/src/android/test/example/devcodelab/DevCodelabTest.java।platform_testing/tests/example/devcodelab/src/android/test/example/devcodelab/DevCodelabTest.javaএডিট করুন এবংAssert.assertTrue(false)-এর জায়গায়Assert.assertTrue(true)লিখুন।আপনি সমস্যার সমাধান করেছেন কিনা তা যাচাই করতে আবার টেস্ট চালান:
atest DevCodelabTest
পর্যালোচনার জন্য আপনার কোড আপলোড করুন
Repo, git clone-এর মতো কমান্ড বান্ডেল করে Git-এর ব্যবহার সহজ করে তোলে যাতে
একসাথে একাধিক Git রিপোজিটরি (বা প্রোজেক্ট) জুড়ে কাজ করা যায়। Git-এ আপনার প্রজেক্টের কোড রিভিউ করার জন্য,
Gerrit ওয়েব-ভিত্তিক কোড রিভিউ সিস্টেম ব্যবহার করুন।
ধরে নেওয়া হচ্ছে যে আপনি
frameworks/nativeপ্রোজেক্টে পরিবর্তন করেছেন, আপনার পরিবর্তন আপলোড করতে এইসব কমান্ড রান করুন:cd frameworks/nativerepo start BRANCH_NAME .git add .git commitআপনার কমিট মেসেজের জন্য, নিম্নলিখিত তথ্য লিখুন:
Android BRANCH_NAME change Test: manual atestআপনার পরিবর্তন আপলোড করুন:
repo uploadআপনি সফল হলে, এই মেসেজের মতো একটি মেসেজ দেখতে পাবেন:
Upload project frameworks/native/ to remote branch android17-release: branch BRANCH_NAME ( 1 commit, Wed Aug 7 09:32:33 2019 -0700): ff46b36d Android BRANCH_NAME change to https://android-review.googlesource.com/ (y/N)? y remote: Processing changes: refs: 1, new: 1, done remote: remote: SUCCESS remote: remote: https://android-review.googlesource.com/c/platform/frameworks/native/+/1098432 Android BRANCH_NAME change [NEW] remote: To https://android-review.googlesource.com/platform/frameworks/native * [new branch] BRANCH_NAME -> refs/for/android17-release
Gerrit-এ আপনার পরিবর্তন দেখুন
Gerrit-এ আপনার করা পরিবর্তন দেখতে, টার্মিনালে আউটপুট লিঙ্কে নেভিগেট করুন। লিঙ্কটি নিম্নলিখিত লিঙ্কের মতো:
https://android-review.googlesource.com/c/platform/frameworks/native/+/1098432
আপনার পরিবর্তন আগের অবস্থায় ফিরিয়ে আনুন
সাধারণত, পরীক্ষা করার পরে এবং পর্যালোচনা ও অনুমোদনের পরে, আপনি Gerrit-এ আপনার পরিবর্তন জমা দেন এবং এটি রিপোজিটরিতে মার্জ করেন। পরিবর্তে, এই কোডল্যাবের উদ্দেশ্যে, আপনার কাজ আগের অবস্থায় ফিরিয়ে আনুন:
Gerrit-এ, পরিত্যাগ করুন বিকল্পে ক্লিক করুন।
frameworks/nativeপ্রোজেক্ট ডিরেক্টরি (বা এর সাবডিরেক্টরি)-তে সংশ্লিষ্ট অস্থায়ী ব্রাঞ্চ পরিত্যাগ করুন:repo abandon BRANCH_NAME .টেস্ট ফাইলে আপনার করা পরিবর্তন আগের অবস্থায় ফিরিয়ে আনুন। আপনি টেস্ট পরিবর্তনে
repo start,git commitএবংrepo uploadরান করেননি বলে, ফাইলটি রিসেট করতে পারবেন। আপনিaosp/platform_testingডিরেক্টরিতে আছেন ধরে নিয়ে, ফাইল রিসেট করতে নিম্নলিখিত কমান্ড ব্যবহার করুন:git reset HEAD tests/example/devcodelab/src/android/test/example/devcodelab/DevCodelabTest.javagit checkout .
Android প্ল্যাটফর্ম ডেভেলপমেন্টের জন্য কোডল্যাব সম্পূর্ণ হয়েছে।
সহায়তা পান
এই কোডল্যাব চলাকালীন আপনি কোনও সমস্যার সম্মুখীন হলে, যেকোনও পৃষ্ঠার নিচে Issue Tracker লিঙ্ক ব্যবহার করে সেগুলির ব্যাপারে অভিযোগ জানান। android-building গ্রুপে প্রশ্ন পাঠান।
crosvm আগে থেকেই চলছে কিনা তা দেখতে ps -A | grep crosvm টাইপ করুন। crosvm
চালু থাকলে, প্রসেস PID সহ stop_cvd || true বা kill crosvm প্রসেস টাইপ করুন।