অ-কোর কোড অবদান

ট্রেডফেডারেশন প্রজেক্টগুলিতে নন-কোর সোর্স কোড অবদানকারী টিমগুলিকে রিভিউ প্রক্রিয়ার সম্পূর্ণ মালিকানা দেওয়ার জন্য, নিম্নলিখিত প্রজেক্টগুলি সমস্ত টিমের জন্য ওপেন +২ রাইটস সহ তৈরি করা হয়েছে। এটি কোর ট্রেডফেডারেশন টিমকে কোর ফ্রেমওয়ার্কের সাথে সম্পর্কহীন সমস্ত কোড রিভিউর বোঝা থেকে মুক্তি দেয় এবং একই সাথে অন্যান্য টিমগুলিকে তাদের রিভিউ চক্রে আরও দ্রুত কাজ করতে সাহায্য করে।

নন-কোর সোর্স বলতে এমন কোডকে বোঝায় যা ট্রেডফেডারেশন ফ্রেমওয়ার্কের কার্যকরী হওয়ার জন্য প্রয়োজনীয় নয় (যেমন কাস্টম টেস্ট, কনফিগারেশন, নির্দিষ্ট টেস্ট ইউটিলিটি)।

গুরুত্বপূর্ণ: নন-কোর সোর্স কোড কোর ট্রেডফেডারেশন ক্লাস এক্সটেন্ড করবে না। এমনটা করলে ভবিষ্যতের রিফ্যাক্টরিং/পরিষ্কার-পরিচ্ছন্নতার উপর প্রভাব পড়ে। আপনার কোড কোর নাকি কন্ট্রিবিউশন-এর অন্তর্ভুক্ত, সে বিষয়ে আপনি নিশ্চিত না হলে, স্পষ্টীকরণের জন্য android-tradefed@-এ যোগাযোগ করুন। কোর ট্রেডফেডারেশন টিম পরামর্শ দিতে এবং ফিচার রিকোয়েস্ট গ্রহণ করতে আগ্রহী।

একটি কোর ট্রেডফেডারেশন ক্লাসের উদাহরণ হলো com.google.android.tradefed.build প্যাকেজের যেকোনো ক্লাস, যেমন: com.google.android.tradefed.build.LaunchControlProvider

android-tradefed@-এর জন্য কোনটি কোর ক্লাস হিসেবে বিবেচিত হবে, সে বিষয়ে আপনার কোনো অস্পষ্টতা থাকলে অনুগ্রহ করে আবার যোগাযোগ করুন।

[সূচিপত্র]

অবদান প্রকল্পগুলির পথ

এই কন্ট্রিবিউশন প্রজেক্টগুলো কাদের জন্য?

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

কন্ট্রিবিউট প্রোজেক্টে কোড পর্যালোচনা

কন্ট্রিবিউশন প্রজেক্টগুলোর লক্ষ্য হলো আপনাকে কোর টিমের (android-tradefed@) পর্যালোচনার প্রয়োজন ছাড়াই ট্রেডফেডে ডেভেলপমেন্ট করার সুযোগ দেওয়া। তাই আমরা আশা করি যে আপনার টিম অথবা আপনার কাজের প্রেক্ষাপটের সাথে পরিচিত যে কেউ আপনার CL-গুলোর কোড রিভিউ করবেন।

কোনো নির্দিষ্ট ক্ষেত্রে আটকে গেলে বা নির্দেশনার প্রয়োজন হলে android-tradefed@-এ নির্দ্বিধায় যোগাযোগ করুন, কিন্তু contrib-এ আপনার কোড রিভিউ করার জন্য ডিফল্টভাবে এর উপর নির্ভর করবেন না। contrib-এ কোড রিভিউর ক্ষেত্রে Tradefed টিমের কোনো SLO (সার্ভিস লিমিটেশন) নেই।

আমি এই প্রকল্পগুলোতে কাজ কোথা থেকে শুরু করতে পারি?

এগুলো নিম্নলিখিত ব্রাঞ্চ ম্যানিফেস্টগুলোতে যোগ করা হয়েছে এবং ইতিমধ্যেই মূল প্ল্যাটফর্ম চেকআউটের অংশ, তাই আপনি যদি আপনার এনভায়রনমেন্টে প্রজেক্টগুলো দেখতে না পান, তবে শুধু একটি রিপো সিঙ্ক করলেই আপনি কন্ট্রিবিউট করতে পারবেন।

  • প্রধান
  • ট্রেডফেড
  • ওসি-ডেভ
  • oc-dev-plus-aosp
  • nyc-mr2-dev-plus-aosp
  • প্রধান-দিবাস্বপ্ন-দেবতা
  • প্রধান-বিক্রেতা-ছাড়া
  • পরিধান-প্রধান

উন্নয়ন এবং পরীক্ষা

অ্যান্ড্রয়েড রিপোজিটরিগুলোর অন্য যেকোনো জায়গার মতোই contrib-এর ডেভেলপমেন্টের মানও একই থাকবে বলে আশা করা হয়:

  • অ্যান্ড্রয়েড ফরম্যাটিং নির্দেশিকা মেনে চলুন
  • কোডটি পরীক্ষা করে টেস্টসহ জমা দেওয়া হয়েছে।
  • ডিজাইনটি সুচিন্তিত এবং যুক্তিসঙ্গত।

আমি কন্ট্রিবিউশনে স্থানীয়ভাবে কীভাবে পরীক্ষা করব?

এওএসপি

AOSP-তে, contrib-এর ইউনিট টেস্টগুলো platform/tools/tradefederation/contrib/tests/src/ ফোল্ডারে থাকে এবং presubmit ও লোকাল টেস্টিং স্ক্রিপ্টে ব্যবহারের জন্য ইউনিট টেস্টগুলোকে com.android.tradefed.prodtests.UnitTests ফাইলে যোগ করতে হয়।

লাঞ্চ চালানোর পর Aosp স্থানীয় স্ক্রিপ্ট:

tools/tradefederation/core/tests/run_tradefed_aosp_presubmit.sh

কন্ট্রিবিউশন প্রোজেক্টগুলিতে বিল্ড নিয়ম আপডেট করুন

বিল্ড রুলস (মেকফাইল) গুলো নিজস্ব build/ ফোল্ডারের অধীনে থাকে এবং একটি OWNERS ফাইল দ্বারা লক করা থাকে, যা কোর টিমের অতিরিক্ত পর্যালোচনা ছাড়া আপনাকে সেগুলো পরিবর্তন করতে বাধা দেয়। `contrib` প্রোজেক্টের এটাই একমাত্র সীমাবদ্ধতা।

কোর টিমের অজান্তে বা তাদের সম্মতি ছাড়া ট্রেডফেড প্রোজেক্টে কোনো অপ্রত্যাশিত ডিপেন্ডেন্সি যুক্ত হচ্ছে কিনা, তা নিশ্চিত করার জন্য এই পর্যালোচনার প্রয়োজন। আপনার যদি সত্যিই কিছু নতুন ডিপেন্ডেন্সি যুক্ত করার প্রয়োজন হয়, তবে আপনার ব্যবহারের ক্ষেত্রগুলো খতিয়ে দেখতে এবং পরামর্শ দেওয়ার জন্য অনুগ্রহ করে android-tradefed@ এ যোগাযোগ করুন।