সিটিএস উন্নয়ন, সিটিএস উন্নয়ন

আপনার রেপো ক্লায়েন্ট শুরু করুন

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

নিম্নলিখিত উদাহরণ কোডটি দেখায় কিভাবে repo init ব্যবহার করতে হয়।

CTS তৈরি করুন এবং চালান

CTS তৈরি করতে এবং ইন্টারেক্টিভ CTS কনসোল শুরু করতে নিম্নলিখিত কমান্ডগুলি কার্যকর করুন:

CTS তৈরি করুন (AOSP 14 বা তার আগের)

cd /path/to/android/root
source build/envsetup.sh
make cts -j32 TARGET_PRODUCT=aosp_arm64
cts-tradefed

বিল্ড সিটিএস (AOSP 15)

cd /path/to/android/root
source build/envsetup.sh
make cts -j32 TARGET_PRODUCT=aosp_arm64 TARGET_RELEASE=target-release
cts-tradefed

target-release মান নির্বাচন করতে অনুগ্রহ করে নিম্নলিখিত টেবিলটি দেখুন:

CTS চালান

CTS কনসোলে, লিখুন:

tf> run cts --plan CTS

CTS পরীক্ষা লিখুন

CTS পরীক্ষাগুলি JUnit এবং Android টেস্টিং API ব্যবহার করে। cts/tests ডিরেক্টরির অধীনে Test your app টিউটোরিয়াল এবং বিদ্যমান পরীক্ষাগুলি পর্যালোচনা করুন। CTS পরীক্ষাগুলি বেশিরভাগ ক্ষেত্রে অন্যান্য Android পরীক্ষায় ব্যবহৃত একই নিয়ম অনুসরণ করে।

CTS অনেক উৎপাদন ডিভাইস জুড়ে চলে, তাই পরীক্ষাগুলিকে এই নিয়মগুলি অনুসরণ করতে হবে:

• বিভিন্ন স্ক্রিনের আকার, ওরিয়েন্টেশন এবং কীবোর্ড লেআউট বিবেচনা করুন।
• শুধুমাত্র পাবলিক API পদ্ধতি ব্যবহার করুন। অন্য কথায়, hide অ্যানোটেশন সহ সমস্ত ক্লাস, পদ্ধতি এবং ক্ষেত্র এড়িয়ে চলুন।
• ভিউ লেআউট ব্যবহার করা বা কিছু ডিভাইসে নাও থাকতে পারে এমন সম্পদের মাত্রার উপর নির্ভর করা এড়িয়ে চলুন।
• রুট সুবিধার উপর নির্ভর করবেন না।

জাভা অ্যানোটেশন যোগ করুন

যদি আপনার পরীক্ষাটি কোনও API আচরণ যাচাই করে, তাহলে @ApiTest দিয়ে আপনার পরীক্ষার কোডটি টীকা করুন এবং apis ক্ষেত্রের সাথে জড়িত সমস্ত API তালিকাভুক্ত করুন। নিম্নলিখিত উদাহরণগুলির মধ্যে থেকে উপযুক্ত ফর্ম্যাটটি ব্যবহার করুন:

যদি আপনার পরীক্ষায় CDD প্রয়োজনীয়তা যাচাই করা হয়, তাহলে নিম্নলিখিত উদাহরণে দেখানো CTS পরীক্ষা কোডে @CddTest দিয়ে প্রয়োজনীয়তা আইডি (CDD সেকশন আইডি এবং প্রয়োজনীয়তা আইডি সহ) টীকা করুন। আপনার কমিট বার্তায়, CDD প্রয়োজনীয়তা আইডি উল্লেখ করে আপনার পরীক্ষা দ্বারা কোন CDD প্রয়োজনীয়তা পরীক্ষা করা হয়েছে তা উল্লেখ করুন। CDD প্রয়োজনীয়তা আইডি হল বিভাগ আইডি এবং প্রয়োজনীয়তা আইডির সংমিশ্রণ, যা 7.3.1/C-1-1-এর মতো একটি স্ল্যাশ (/) দ্বারা সংযুক্ত।

/**
* Verify Passpoint configuration management APIs for a Passpoint
* @throws Exception
*/
    @CddTest(requirement="7.4.2.3/C-1-1,C-2-1")
    public void testAddPasspointConfigWithUserCredential() throws Exception {
        if (!WifiFeature.isWifiSupported(getContext())) {
            // skip the test if WiFi is not supported
            return;
        }      testAddPasspointConfig(generatePasspointConfig(generateUserCredential()));
    }

CTS Verifier-এর জন্য, আপনার AndroidManifest.xml এ প্রতিটি Activity-কে প্রাসঙ্গিক CDD ID দিয়ে টীকা করুন। মান ক্ষেত্রগুলির ফর্ম্যাটগুলি CTS-এর জাভা অ্যানোটেশনের ফর্ম্যাটের মতো। কমিট বার্তায়, CDD প্রয়োজনীয়তা ID উল্লেখ করে কোন CDD প্রয়োজনীয়তা প্রয়োগ করা হয়েছে তা উল্লেখ করুন।

  <activity>
    ......
    <!-- OPTIONAL: Add a meta data attribute to indicate CDD requirements. -->
    <meta-data android:name="cdd_test" android:value="7.4.1/C-4-1" />

    <!-- OPTIONAL: Add a meta data attribute to indicate APIs being tested. -->
    <meta-data android:name="api_test"
               android:value="com.example.MyClass#myMethod" />

    <!-- OPTIONAL: Add a metadata attribute to indicate the reason why the test doesn't enforce any CDD requirement but still useful in CTS-V. -->
    <meta-data android:name="non_compliance_test"
               android:value="detailed reasons" />
  </activity>

কমিট বার্তায়

আপনার পরীক্ষা কেন যোগ করা প্রয়োজন তা স্পষ্টভাবে উল্লেখ করুন এবং সহায়তার জন্য প্রাসঙ্গিক লিঙ্ক যোগ করুন। CTS-D পরীক্ষার জন্য, CTS-D জমা দেওয়ার প্রক্রিয়ার অংশ হিসেবে Google Issue Tracker-এ আপনার তৈরি করা পরীক্ষার প্রস্তাবের একটি লিঙ্ক অন্তর্ভুক্ত করুন।

একটি সাবপ্ল্যান তৈরি করুন

উদাহরণস্বরূপ, আপনি android-cts/subplans এ একটি SubPlan.xml ফাইল নিম্নরূপ যোগ করতে পারেন:

<?xml version="1.0" encoding="utf-8" standalone="no"?>
<SubPlan version="2.0">
<Entry include="CtsSystemIntentTestCases" />
<Entry include="CtsSystemUiHostTestCases" />
<Entry include="CtsSecurityHostTestCases android.security.cts.SELinuxHostTest#testAospFileContexts" />
<Entry include="CtsSecurityHostTestCases android.security.cts.SELinuxHostTest#testAospServiceContexts" />
</SubPlan>

সাবপ্ল্যানটি চালানোর জন্য:

run cts --subplan aSubPlan

সাবপ্ল্যান এন্ট্রি ফর্ম্যাটটি হল:

Include a module name as follows:
<Entry include="MODULE_NAME" />

Include a package:
<Entry include="MODULE_NAME PACKAGE_NAME" />

Include a class:
<Entry include="MODULE_NAME PACKAGE_NAME.CLASS_NAME" />

Include an individual test:
<Entry include="MODULE_NAME PACKAGE_NAME.CLASS_NAME#TEST_NAME" />

পরীক্ষার নামকরণ এবং অবস্থান

বেশিরভাগ CTS টেস্ট কেস অ্যান্ড্রয়েড API-তে একটি নির্দিষ্ট ক্লাসকে লক্ষ্য করে। এই পরীক্ষাগুলিতে জাভা প্যাকেজের নাম cts সাফিক্স সহ এবং ক্লাসের নাম Test সাফিক্স সহ থাকে। প্রতিটি টেস্ট কেস একাধিক পরীক্ষা নিয়ে গঠিত, যেখানে প্রতিটি পরীক্ষা সাধারণত পরীক্ষা করা ক্লাসের একটি নির্দিষ্ট পদ্ধতি অনুশীলন করে। এই পরীক্ষাগুলি একটি ডিরেক্টরি কাঠামোতে সাজানো হয় যেখানে পরীক্ষাগুলিকে "উইজেট" বা "ভিউ" এর মতো বিভিন্ন বিভাগে ভাগ করা হয়।

উদাহরণস্বরূপ, জাভা প্যাকেজ android.widget.TextView এর জন্য CTS পরীক্ষা হল android.widget.cts.TextViewTest যার জাভা প্যাকেজের নাম android.widget.cts এবং ক্লাসের নাম TextViewTest ।

• জাভা প্যাকেজের নাম
  CTS পরীক্ষার জন্য জাভা প্যাকেজের নাম হল সেই ক্লাসের প্যাকেজের নাম যা পরীক্ষাটি পরীক্ষা করছে, তার পরে .cts । আমাদের উদাহরণের জন্য, প্যাকেজের নাম হবে android.widget.cts ।
• ক্লাসের নাম
  CTS পরীক্ষার ক্লাসের নাম হল "Test" যুক্ত করে পরীক্ষা করা ক্লাসের নাম। উদাহরণস্বরূপ, যদি কোনও পরীক্ষা TextView লক্ষ্য করে থাকে, তাহলে ক্লাসের নাম TextViewTest হওয়া উচিত।
• মডিউলের নাম (শুধুমাত্র CTS v2)
  CTS v2 মডিউল অনুসারে পরীক্ষা পরিচালনা করে। মডিউলের নাম সাধারণত জাভা প্যাকেজ নামের দ্বিতীয় স্ট্রিং (আমাদের উদাহরণে, widget )।

ডিরেক্টরি কাঠামো এবং নমুনা কোড নির্ভর করে আপনি CTS v1 নাকি CTS v2 ব্যবহার করছেন তার উপর।

সিটিএস ভি১

অ্যান্ড্রয়েড ৬.০ বা তার নিচের ভার্সনের জন্য, CTS v1 ব্যবহার করুন। CTS v1 এর জন্য, নমুনা কোডটি cts/tests/tests/example এ রয়েছে।

CTS v1 পরীক্ষায় ডিরেক্টরি কাঠামোটি এরকম দেখাচ্ছে:

cts/
  tests/
    tests/
      package-name/
        Android.mk
        AndroidManifest.xml
        src/
          android/
            package-name/
              SampleDeviceActivity.java
              cts/
                SampleDeviceTest.java

সিটিএস ভি২

অ্যান্ড্রয়েড ৭.০ বা তার উচ্চতর সংস্করণের জন্য, CTS v2 ব্যবহার করুন। বিস্তারিত জানার জন্য, অ্যান্ড্রয়েড ওপেন সোর্স প্রজেক্ট (AOSP) এর নমুনা পরীক্ষাটি দেখুন।

CTS v2 ডিরেক্টরি কাঠামোটি দেখতে এরকম:

cts/
  tests/
    module-name/
      Android.mk
      AndroidManifest.xml
      src/
        android/
          package-name/
            SampleDeviceActivity.java
            cts/
              SampleDeviceTest.java

নতুন নমুনা প্যাকেজ

নতুন পরীক্ষা যোগ করার সময়, আপনার পরীক্ষা রাখার জন্য কোনও বিদ্যমান ডিরেক্টরি নাও থাকতে পারে। এই ক্ষেত্রে, আপনাকে ডিরেক্টরি তৈরি করতে হবে এবং উপযুক্ত নমুনা ফাইলগুলি অনুলিপি করতে হবে।

সিটিএস ভি১

যদি আপনি CTS v1 ব্যবহার করেন, তাহলে cts/tests/tests/example অধীনে উদাহরণটি দেখুন এবং একটি নতুন ডিরেক্টরি তৈরি করুন। এছাড়াও, আপনার নতুন প্যাকেজের মডিউলের নামটি Android.mk থেকে cts/CtsTestCaseList.mk এর CTS_COVERAGE_TEST_CASE_LIST এ যোগ করতে ভুলবেন না। build/core/tasks/cts.mk এই makefile ব্যবহার করে সমস্ত পরীক্ষা একত্রিত করে চূড়ান্ত CTS প্যাকেজ তৈরি করে।

সিটিএস ভি২

নিম্নলিখিত ধাপগুলি অনুসরণ করে আপনার নতুন পরীক্ষা মডিউলটি দ্রুত শুরু করতে নমুনা পরীক্ষা /cts/tests/sample/ ব্যবহার করুন:

1. পরীক্ষা ডিরেক্টরি তৈরি করতে এবং নমুনা ফাইলগুলি অনুলিপি করতে, চালান:

   mkdir cts/tests/module-name && cp -r cts/tests/sample/* cts/tests/module-name

2. cts/tests/ module-name এ যান এবং "[Ss]ample"-এর সমস্ত উদাহরণ উপরে থেকে প্রস্তাবিত নামকরণ কনভেনশন দিয়ে প্রতিস্থাপন করুন।
3. আপনি যে বৈশিষ্ট্যটি পরীক্ষা করছেন তা ব্যবহার করতে SampleDeviceActivity আপডেট করুন।
4. কার্যকলাপটি সফল হয়েছে কিনা বা এর ত্রুটিগুলি লগ করেছে কিনা তা নিশ্চিত করতে SampleDeviceTest আপডেট করুন।

অতিরিক্ত ডিরেক্টরি

অন্যান্য অ্যান্ড্রয়েড ডিরেক্টরি যেমন assets , jni , libs , এবং res ও যোগ করা যেতে পারে। JNI কোড যোগ করতে, src এর পাশে প্রজেক্টের রুটে একটি ডিরেক্টরি তৈরি করুন যাতে নেটিভ কোড এবং একটি Android.mk makefile থাকে।

মেকফাইলে সাধারণত নিম্নলিখিত সেটিংস থাকে:

LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE := libCtsSample_jni

# don't include this package in any target
LOCAL_MODULE_TAGS := optional
LOCAL_SRC_FILES := list of source code files
LOCAL_C_INCLUDES := $(JNI_H_INCLUDE)

# Tag this module as a cts test artifact
LOCAL_COMPATIBILITY_SUITE := cts
LOCAL_SHARED_LIBRARIES := libnativehelper
LOCAL_SDK_VERSION := current
include $(BUILD_SHARED_LIBRARY)

Android.mk ফাইল

অবশেষে, নীচে দেখানো হিসাবে, নেটিভ কোড তৈরি করতে এবং এর উপর নির্ভর করতে প্রকল্পের রুটে থাকা Android.mk ফাইলটি পরিবর্তন করুন:

# All tests should include android.test.runner.
LOCAL_JAVA_LIBRARIES := android.test.runner

# Includes the jni code as a shared library
LOCAL_JNI_SHARED_LIBRARIES := libCtsSample_jni

# Include for InstrumentationCtsTestRunner
LOCAL_STATIC_JAVA_LIBRARIES := ctstestrunner...
LOCAL_SDK_VERSION := currentinclude $(BUILD_CTS_PACKAGE)

#Tells make to look in subdirectories for more make files to include
include $(call all-makefiles-under,$(LOCAL_PATH))

পরীক্ষাগুলি ঠিক করুন বা সরান

নতুন পরীক্ষা যোগ করার পাশাপাশি, আপনি BrokenTest বা KnownFailure দিয়ে টীকাযুক্ত পরীক্ষাগুলি ঠিক করতে বা সরাতে পারেন।

আপনার পরিবর্তনগুলি জমা দিন

CTS-এ পরিবর্তনগুলি অবদান রাখার সময় জমা দেওয়ার কোড পরিবর্তনের কর্মপ্রবাহ অনুসরণ করুন।

• প্যাচটি যে API স্তরে প্রযোজ্য তার উপর ভিত্তি করে ডেভেলপমেন্ট শাখাটি নির্বাচন করুন।
• কমিট মেসেজে DO NOT MERGE অথবা RESTRICT AUTOMERGE লিখে সঠিক টেস্ট ব্রাঞ্চে পরিবর্তনগুলি ডেভেলপ বা চেরিপিক করুন।

একজন পর্যালোচককে আপনার পরিবর্তন পর্যালোচনা করার জন্য নিযুক্ত করা হয়েছে এবং সেই অনুযায়ী অভ্যন্তরীণ Gerrit-এ পরিবর্তনটি চেরি-পিক করার জন্য নিযুক্ত করা হয়েছে।

প্রকাশের সময়সূচী এবং শাখার তথ্য

সিটিএস রিলিজগুলি এই সময়সূচী অনুসরণ করে।

মুক্তির সময় গুরুত্বপূর্ণ তারিখগুলি

• প্রথম সপ্তাহের শেষে: কোড ফ্রিজ। CTS-এর আসন্ন সংস্করণের জন্য কোড ফ্রিজ না হওয়া পর্যন্ত শাখায় মার্জ করা পরিবর্তনগুলি বিবেচনা করা হয়। কোড ফ্রিজের পরে, অথবা প্রকাশের জন্য প্রার্থী নির্বাচিত হওয়ার পরে, শাখায় জমা দেওয়া তথ্য পরবর্তী প্রকাশের জন্য বিবেচনা করা হয়।
• দ্বিতীয় বা তৃতীয় সপ্তাহ: CTS কম্প্যাটিবিলিটি টেস্ট স্যুট ডাউনলোড পৃষ্ঠায় প্রকাশিত হয়।

অটোমার্জ প্রবাহ

সিটিএস ডেভেলপমেন্ট শাখাগুলি এমনভাবে স্থাপন করা হয়েছে যাতে প্রতিটি শাখায় জমা দেওয়া পরিবর্তনগুলি স্বয়ংক্রিয়ভাবে উচ্চতর শাখায় একত্রিত হয়।

AOSP টেস্ট ডেভ শাখায় সরাসরি পরিবর্তনের জন্য, অটোমার্জ পাথ হল:
android13-tests-dev > android14-tests-dev > android15-tests-dev

• CTS ১৬+ সংস্করণের জন্য, একজন পর্যালোচক অভ্যন্তরীণ Gerrit-এ পরিবর্তনটি সেই অনুযায়ী বেছে নেবেন।

যদি কোনও চেঞ্জলিস্ট (CL) সঠিকভাবে মার্জ করতে ব্যর্থ হয়, তাহলে প্যাচের লেখককে দ্বন্দ্ব সমাধানের নির্দেশাবলী সহ একটি ইমেল পাঠানো হয়। বেশিরভাগ ক্ষেত্রে, প্যাচের লেখক দ্বন্দ্বী CL এর অটোমার্জ এড়িয়ে যাওয়ার জন্য নির্দেশাবলী ব্যবহার করতে পারেন।

যদি কোনও পুরোনো শাখা পরিবর্তনের প্রয়োজন হয়, তাহলে নতুন শাখা থেকে প্যাচটি চেরি-পিক করতে হবে।

পরবর্তী অ্যান্ড্রয়েড সংস্করণে প্রযোজ্য পরীক্ষামূলক পরিবর্তনের জন্য, প্রস্তাবিত পরিবর্তন আপলোড করার পরে, গুগল এটি পর্যালোচনা করে এবং গৃহীত হলে, এটি অভ্যন্তরীণ Gerrit-এ চেরি-পিক করবে।