มีส่วนร่วมในโค้ดที่ไม่ใช่โค้ดหลัก

เราได้สร้างโปรเจ็กต์ต่อไปนี้ที่มีสิทธิ์ +2 แบบเปิดสำหรับทุกทีมเพื่อให้ทีมที่มีส่วนร่วมใน src ที่ไม่สําคัญในโปรเจ็กต์ของ Trade Federation เป็นเจ้าของกระบวนการตรวจสอบโดยสมบูรณ์ ซึ่งจะช่วยบรรเทาภาระของทีม Tradefederation หลักจากการตรวจสอบโค้ดทั้งหมดที่ไม่เกี่ยวข้องกับเฟรมเวิร์กหลัก และช่วยให้ทีมอื่นๆ สามารถทำซ้ำในวงจรการตรวจสอบได้เร็วขึ้น

src ที่ไม่ใช่โค้ดหลักหมายถึงโค้ดที่เฟรมเวิร์กการรวมข้อมูลทางการค้าไม่จําเป็นต้องใช้เพื่อให้ทํางานได้ (เช่น การทดสอบที่กําหนดเอง การกําหนดค่า ยูทิลิตีการทดสอบที่เฉพาะเจาะจง)

สำคัญ src ที่ไม่สําคัญไม่ควรขยายคลาส tradefederation หลัก เนื่องจากจะส่งผลต่อการปรับโครงสร้าง/การจัดระเบียบใหม่ในอนาคต หากไม่แน่ใจว่าโค้ดของคุณอยู่ใน core หรือ contrib โปรดติดต่อ android-tradefed@ เพื่อขอคำชี้แจง ทีม Trade Federation หลักยินดีให้คำแนะนำและรับคำขอฟีเจอร์

ตัวอย่างคลาสหลักของ tradefederation คือคลาสใดก็ได้ในแพ็กเกจ com.google.android.tradefed.build เช่น com.google.android.tradefed.build.LaunchControlProvider

โปรดติดต่อเราอีกครั้งหากไม่แน่ใจว่าคลาสใดจะถือว่าเป็นคลาสหลักที่ android-tradefed@

[TOC]

เส้นทางของโปรเจ็กต์ Contrib

โปรเจ็กต์การมีส่วนร่วมเหล่านี้มีไว้สำหรับใคร

หากคุณทํางานในโปรเจ็กต์ Trade Federation ที่เขียนการทดสอบ/ยูทิลิตีการทดสอบ/การกําหนดค่า โปรเจ็กต์เหล่านี้สร้างขึ้นสําหรับคุณ

การตรวจสอบโค้ดในโปรเจ็กต์ contrib

เป้าหมายของโปรเจ็กต์ contrib คือช่วยให้คุณพัฒนาใน Tradefed ได้โดยไม่ต้องผ่านการตรวจสอบจากทีมหลัก (android-tradefed@) เราจึงคาดหวังให้ทีมของคุณหรือผู้ที่คุ้นเคยกับบริบทของคุณเป็นผู้ตรวจสอบโค้ดใน CL

โปรดติดต่อ android-tradefed@ เสมอหากพบปัญหาหรือต้องการคำแนะนำสำหรับเคสหนึ่งๆ แต่อย่าใช้อีเมลนี้โดยค่าเริ่มต้นเพื่อตรวจสอบโค้ดใน contrib ทีม Tradefed ไม่มี SLO สำหรับการตรวจสอบโค้ดใน contrib

ฉันจะเริ่มต้นทำงานในโปรเจ็กต์เหล่านี้ได้จากที่ไหน

เราได้เพิ่มโปรเจ็กต์เหล่านี้ลงในไฟล์ Manifest ของสาขาต่อไปนี้และเป็นส่วนหนึ่งของการชำระเงินบนแพลตฟอร์มหลักแล้ว ดังนั้นหากคุณไม่เห็นโปรเจ็กต์ในสภาพแวดล้อมของคุณ แสดงว่าคุณยังไม่ได้ซิงค์ที่เก็บข้อมูลเพื่อมีส่วนร่วม

  • หลัก
  • tradefed
  • oc-dev
  • oc-dev-plus-aosp
  • nyc-mr2-dev-plus-aosp
  • main-daydream-dev
  • main-without-vendor
  • wear-main

การพัฒนาและการทดสอบ

การพัฒนาใน contrib คาดว่าจะมีมาตรฐานคุณภาพเดียวกันกับที่เก็บอื่นๆ ใน Android ดังนี้

  • ปฏิบัติตามหลักเกณฑ์การจัดรูปแบบของ Android
  • ทดสอบโค้ดและส่งพร้อมกับการทดสอบ
  • การออกแบบมีความใส่ใจและสมเหตุสมผล

ฉันจะทดสอบในเครื่องใน contrib ได้อย่างไร

AOSP

ใน aosp การทดสอบ 1 หน่วยของ contrib จะอยู่ใน platform/tools/tradefederation/contrib/tests/src/ และควรเพิ่มการทดสอบ 1 หน่วยลงใน com.android.tradefed.prodtests.UnitTests เพื่อให้สคริปต์การทดสอบก่อนส่งและทดสอบในเครื่องเรียกใช้

สคริปต์ในเครื่อง Aosp หลังจากเรียกใช้ lunch

tools/tradefederation/core/tests/run_tradefed_aosp_presubmit.sh

อัปเดตกฎการสร้างในโปรเจ็กต์ contrib

กฎการสร้าง (ไฟล์ make) จะอยู่ภายใต้โฟลเดอร์ build/ ของตัวเองและถูกล็อกโดยไฟล์ OWNERS ซึ่งจะป้องกันไม่ให้คุณแก้ไขกฎเหล่านี้ได้หากไม่ได้รับการตรวจสอบเพิ่มเติมจากทีมหลัก ข้อจำกัดเพียงอย่างเดียวของโปรเจ็กต์ contrib

เราจําเป็นต้องตรวจสอบเพื่อให้แน่ใจว่าไม่มีการเพิ่มการพึ่งพาที่ไม่คาดคิดในโปรเจ็กต์ Tradefed โดยที่ทีมหลักไม่ทราบหรือไม่ได้ให้ความยินยอม หากต้องการเพิ่มข้อกำหนดใหม่จริงๆ โปรดติดต่อ android-tradefed@ เพื่อตรวจสอบ Use Case และแนะนำคุณ