Android ডেভেলপমেন্ট করে দেখুন

এই টিউটোরিয়াল আপনাকে প্রথমবার 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 ইনস্টল করতে এইসব ধাপ অনুসরণ করুন:

  1. বর্তমান প্যাকেজের তথ্য ডাউনলোড করুন:

    sudo apt-get update
  2. Repo লঞ্চার ইনস্টল করতে এই কমান্ড রান করুন:

    sudo apt-get install repo

    Repo লঞ্চার একটি Python স্ক্রিপ্ট প্রদান করে যা একটি চেকআউট শুরু করে এবং সম্পূর্ণ Repo টুল ডাউনলোড করে।

    হয়ে গেলে, ধাপ ৪-এ যান।

  3. ঐচ্ছিক: নিম্নলিখিত কমান্ডের সিরিজ ব্যবহার করে ম্যানুয়ালি Repo ইনস্টল করুন:

    export REPO=$(mktemp /tmp/repo.XXXXXXXXX)
    curl -o ${REPO} https://storage.googleapis.com/git-repo-downloads/repo
    gpg --recv-keys 8BB9AD793E8E6153AF0F9A4416530D5E920F5C65
    curl -s https://storage.googleapis.com/git-repo-downloads/repo.asc | gpg --verify - ${REPO} && install -m 755 ${REPO} ~/bin/repo

    প্রথম তিনটি কমান্ড একটি টেম্প ফাইল সেট-আপ করে, ফাইলে Repo ডাউনলোড করে এবং প্রদান করা কী প্রয়োজনীয় কী-এর সাথে মিলছে কিনা তা যাচাই করে। এই কমান্ডগুলি সফল হলে, চূড়ান্ত কমান্ড Repo লঞ্চার ইনস্টল করে।

  4. Repo লঞ্চার ভার্সন যাচাই করুন:

    repo version

    আউটপুটে ২.৪ বা তার পরের যেকোনও ভার্সন দেখাতে হবে, যেমন:

    repo launcher version 2.45
    

Android সোর্স ডাউনলোড করুন

Android সোর্স, Google-এর হোস্ট করা Git রিপোজিটরির সংগ্রহে রয়েছে। প্রতিটি Git রিপোজিটরিতে Android সোর্সের সম্পূর্ণ ইতিহাস অন্তর্ভুক্ত থাকে, যার মধ্যে সোর্সে করা পরিবর্তন এবং কখন পরিবর্তন করা হয়েছে তা অন্তর্ভুক্ত থাকে। Android সোর্স ডাউনলোড করতে:

  1. আপনার হোম ডিরেক্টরিতে নেভিগেট করুন:

    cd ~
  2. এর মধ্যে একটি লোকাল ওয়ার্কিং সাবডিরেক্টরি তৈরি করুন:

    mkdir aosp
  3. ডিরেক্টরিতে নেভিগেট করুন:

    cd aosp
  4. AOSP রিপোজিটরি সোর্স কোডের লেটেস্ট রিলিজ ব্রাঞ্চ ইনিশিয়ালাইজ করুন (android-latest-release):

    repo init --partial-clone -b android-latest-release -u https://android.googlesource.com/platform/manifest
  5. আপনার Git ক্রেডেনশিয়াল (নাম, ইমেল আইডি) লিখুন বা গ্রহণ করুন।

  6. সোর্স কোড সিঙ্ক করুন:

    repo sync -c -j8

    ডাউনলোড করার সময় কোনও সমস্যা হলে, সিঙ্ক সংক্রান্ত সমস্যার সমাধান করুন লিঙ্কটি দেখুন।

কোড তৈরি করুন

কোড তৈরি করতে:

  1. আপনার ওয়ার্কিং ডিরেক্টরি থেকে, বিল্ড এনভায়রনমেন্ট সেট-আপ করতে envsetup.sh স্ক্রিপ্ট সোর্স করুন:

    source build/envsetup.sh
  2. lunch কমান্ডের সাহায্যে তৈরি করার জন্য টার্গেট ডিভাইসের ধরন উল্লেখ করুন। টার্গেট হল ডিভাইসের পারমুটেশন, যেমন নির্দিষ্ট মডেল বা ফর্ম ফ্যাক্টর। এই টার্গেট নির্দিষ্ট করুন:

    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
    ============================================
    
  3. টার্গেট তৈরি করুন:

    m

প্রথম বিল্ড তৈরি হতে কয়েক ঘণ্টা সময় লাগতে পারে। পরবর্তী বিল্ডগুলি উল্লেখযোগ্যভাবে কম সময় নেয়। আপনার বিল্ডের আউটপুট $OUT_DIR-এ দেখা যাবে।

Cuttlefish লঞ্চ করুন

Cuttlefish হল Android এমুলেটর যা আপনার বিল্ড পরীক্ষা করতে ব্যবহার করা হয়।

  1. হোস্ট Debian প্যাকেজ ডাউনলোড, তৈরি ও ইনস্টল করতে নিম্নলিখিত কমান্ডগুলি রান করুন:

    sudo apt install -y git devscripts equivs config-package-dev debhelper-compat golang curl
    git clone https://github.com/google/android-cuttlefish
    cd android-cuttlefish
    tools/buildutils/build_packages.sh
    sudo apt install -y ./cuttlefish-base_*.deb ./cuttlefish-user_*.deb
    sudo usermod -aG kvm,cvdnetwork,render $USER
    sudo reboot

    রিবুট করার ফলে অতিরিক্ত কার্নেল মডিউল ইনস্টল হয় এবং udev নিয়ম প্রযোজ্য হয়।

  2. আপনার ওয়ার্কস্টেশন রিবুট করার পরে, আপনার aosp ডিরেক্টরিতে নেভিগেট করুন, আপনার বিল্ড এনভায়রনমেন্ট সেট-আপ করুন এবং Cuttlefish লঞ্চ করুন:

    cd ~/aosp
    source build/envsetup.sh
    lunch aosp_cf_x86_64_only_phone-aosp_current-userdebug
    launch_cvd --daemon
  3. আপনার ওয়েব ব্রাউজারে https://localhost:8443-এ নেভিগেট করে Cuttlefish ডিভাইসে কানেক্ট করুন। আপনার ভার্চুয়াল Android-চালিত ডিভাইস দেখানো হয়েছে।

কোনও পরিবর্তন করুন

এই উদাহরণ পরিবর্তনের তালিকা অনুসরণ করে সোর্স কোড আপডেট করুন।

  1. আপনার চেকআউটের রুট (aosp/ ডিরেক্টরি) থেকে, frameworks/native Git প্রোজেক্টে নেভিগেট করুন:

    cd frameworks/native
  2. এই কমান্ডের সাহায্যে একটি সাময়িক ব্রাঞ্চ শুরু করুন:

    repo start BRANCH_NAME .
  3. নিম্নলিখিত লোকেশনে SurfaceFlinger.cpp এডিট করতে আপনার এডিটর ব্যবহার করুন:

    aosp/frameworks/native/services/surfaceflinger/SurfaceFlinger.cpp
    
  4. এই লাইনটি খুঁজুন:

    void SurfaceFlinger::updateColorMatrixLocked() {
    
  5. 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});
    
  6. কোড তৈরি করুন:

    m
  7. ডিভাইসে বিল্ড আপডেট করুন:

    adb root
    adb remount -R
    adb root
    adb sync
    adb reboot
  8. আপনার বেছে নেওয়া ডিভাইসে রঙের পরিবর্তন দেখতে পাচ্ছেন কিনা তা যাচাই করুন।

কোনও টেস্ট ঠিক করা

কোডল্যাবের এই অংশটি সোর্স ট্রিতে থাকা একটি উদাহরণ টেস্ট ব্যবহার করে এবং এটি ব্যর্থ হচ্ছে। টেস্ট রান, ডিবাগ ও সমাধান করতে, এই নির্দেশাবলী অনুসরণ করুন:

  1. রান করুন:

    atest DevCodelabTest

    টেস্ট করা যায়নি।

  2. ব্যর্থ হওয়া টেস্টের স্ট্যাক ট্রেস পরীক্ষা করুন:

    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 নামের ফাইলে আছে।

  3. যে টেস্টটি ঠিক করতে হবে তার লোকেশন নির্ধারণ করতে, টেস্ট ফাইলের নাম সহ স্ট্যাক ট্রেসের শেষ লাইনে 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।

  4. platform_testing/tests/example/devcodelab/src/android/test/example/devcodelab/DevCodelabTest.java এডিট করুন এবং Assert.assertTrue(false)-এর জায়গায় Assert.assertTrue(true) লিখুন।

  5. আপনি সমস্যার সমাধান করেছেন কিনা তা যাচাই করতে আবার টেস্ট চালান:

    atest DevCodelabTest

পর্যালোচনার জন্য আপনার কোড আপলোড করুন

Repo, git clone-এর মতো কমান্ড বান্ডেল করে Git-এর ব্যবহার সহজ করে তোলে যাতে একসাথে একাধিক Git রিপোজিটরি (বা প্রোজেক্ট) জুড়ে কাজ করা যায়। Git-এ আপনার প্রজেক্টের কোড রিভিউ করার জন্য, Gerrit ওয়েব-ভিত্তিক কোড রিভিউ সিস্টেম ব্যবহার করুন।

  1. ধরে নেওয়া হচ্ছে যে আপনি frameworks/native প্রোজেক্টে পরিবর্তন করেছেন, আপনার পরিবর্তন আপলোড করতে এইসব কমান্ড রান করুন:

    cd frameworks/native
    repo start BRANCH_NAME .
    git add .
    git commit
  2. আপনার কমিট মেসেজের জন্য, নিম্নলিখিত তথ্য লিখুন:

    Android BRANCH_NAME change
    Test: manual atest
    
  3. আপনার পরিবর্তন আপলোড করুন:

    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-এ আপনার পরিবর্তন জমা দেন এবং এটি রিপোজিটরিতে মার্জ করেন। পরিবর্তে, এই কোডল্যাবের উদ্দেশ্যে, আপনার কাজ আগের অবস্থায় ফিরিয়ে আনুন:

  1. Gerrit-এ, পরিত্যাগ করুন বিকল্পে ক্লিক করুন।

  2. frameworks/native প্রোজেক্ট ডিরেক্টরি (বা এর সাবডিরেক্টরি)-তে সংশ্লিষ্ট অস্থায়ী ব্রাঞ্চ পরিত্যাগ করুন:

    repo abandon BRANCH_NAME .
  3. টেস্ট ফাইলে আপনার করা পরিবর্তন আগের অবস্থায় ফিরিয়ে আনুন। আপনি টেস্ট পরিবর্তনে repo start, git commit এবং repo upload রান করেননি বলে, ফাইলটি রিসেট করতে পারবেন। আপনি aosp/platform_testing ডিরেক্টরিতে আছেন ধরে নিয়ে, ফাইল রিসেট করতে নিম্নলিখিত কমান্ড ব্যবহার করুন:

    git reset HEAD tests/example/devcodelab/src/android/test/example/devcodelab/DevCodelabTest.java
    git checkout .

Android প্ল্যাটফর্ম ডেভেলপমেন্টের জন্য কোডল্যাব সম্পূর্ণ হয়েছে।

সহায়তা পান

এই কোডল্যাব চলাকালীন আপনি কোনও সমস্যার সম্মুখীন হলে, যেকোনও পৃষ্ঠার নিচে Issue Tracker লিঙ্ক ব্যবহার করে সেগুলির ব্যাপারে অভিযোগ জানান। android-building গ্রুপে প্রশ্ন পাঠান।

crosvm আগে থেকেই চলছে কিনা তা দেখতে ps -A | grep crosvm টাইপ করুন। crosvm চালু থাকলে, প্রসেস PID সহ stop_cvd || true বা kill crosvm প্রসেস টাইপ করুন।