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

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

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

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

ตัวอย่างคลาสหลักของ 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 ทีมที่เทรดไม่มี SLO สำหรับการตรวจสอบโค้ดในการเชื่อมต่อ

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

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

  • หลัก
  • 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 เพื่อให้สคริปต์การทดสอบก่อนส่งและทดสอบในเครื่องเรียกใช้

ข้ามสคริปต์ในเครื่องหลังอาหารกลางวัน:

tools/tradefederation/core/tests/run_tradefed_aosp_presubmit.sh

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

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

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