APK และแทร็ก

Google Play Developer API ช่วยให้คุณอัปโหลด APK ใหม่สำหรับแอปของคุณได้ และเผยแพร่ในแทร็กการเผยแพร่อื่น วิธีนี้ช่วยให้คุณทำสิ่งต่อไปนี้ได้ ทำให้แอปเวอร์ชันอัลฟ่าและเบต้าใช้งานได้ แก่ผู้ใช้ที่ได้รับอนุมัติ นอกจากนี้ ยังช่วยให้คุณทำให้การเปิดตัวแบบทีละขั้นใช้งานได้ด้วย ซึ่งจะมีให้บริการโดยอัตโนมัติสำหรับ ผู้ใช้แอปได้อย่างไร เมื่อเผยแพร่เวอร์ชันการเปิดตัวแบบทีละขั้นแล้ว คุณสามารถค่อยๆ เพิ่มจำนวนผู้ใช้ที่ได้รับ กับแอปของคุณ จนกว่าคุณจะทำให้เวอร์ชันดังกล่าวเป็น "การใช้งานจริง" เวอร์ชัน

การเพิ่มและแก้ไข APK

  1. อัปโหลด APK อย่างน้อย 1 รายการโดยเรียกใช้ วิธี Edits.apks: อัปโหลด

    เมธอดนี้จะอัปโหลด APK ลงใน "ที่เก็บข้อมูล" ของพื้นที่เก็บข้อมูล ซึ่งสามารถ ถูกกำหนดให้กับ "แทร็ก" เพื่อทำให้ผู้ใช้สามารถใช้งานได้ (หากการแก้ไขคือ ถูกลบหรือทิ้งไป APK ที่อัปโหลดไปยังการแก้ไขนั้นจะยัง lost.)

  2. เผยแพร่ APK ใน "tracks" โดยการโทร Edits.tracks: อัปเดต คุณสามารถปล่อย APK ในแทร็กต่อไปนี้

    • แทร็กทดสอบ เช่น "alpha" และ "beta"

      ทำให้แอปเวอร์ชันอัลฟ่าและเบต้าใช้งานได้สำหรับผู้ใช้ ที่คุณกำหนดให้กับกลุ่มทดสอบอัลฟ่าและเบต้า คุณมอบหมาย ผู้ใช้ในกลุ่มเหล่านี้โดยใช้ Google Play Console

    • แทร็กทดสอบภายใน: "qa"

      เวอร์ชันภายในของแอปใช้งานได้กับการทดสอบภายในแล้ว ติดตามที่ได้รับการกำหนดค่าใน Google Play Console

    • แทร็กเวอร์ชันที่ใช้งานจริง: "production"

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

    ผู้ใช้ในโหมดเรียบง่ายไม่ควรวาง APK มากกว่า 1 รายการไว้ใน ติดตาม ผู้ใช้โหมดขั้นสูงที่ใช้ APK หลายรายการ การสนับสนุน สามารถอัปโหลด APK ศูนย์ หนึ่ง หรือหลายรายการไปยังแต่ละแทร็กได้

ชื่อแทร็กสำหรับแทร็กรูปแบบของอุปกรณ์

ชื่อแทร็กสำหรับแทร็กประเภทของอุปกรณ์จะมีคำนำหน้าที่เฉพาะเจาะจง ของคุณ

รูปแบบของอุปกรณ์ คำนำหน้า
Android Automotive OS ยานยนต์
Wear OS Wear
Android TV ทีวี

วิธีคํานวณชื่อแทร็กสําหรับแทร็กรูปแบบของอุปกรณ์หนึ่งๆ

ประเภทแทร็กทั่วไป เช่น เวอร์ชันที่ใช้งานจริง การทดสอบแบบเปิด และแทร็กภายใน แทร็กทดสอบมีชื่อแทร็กที่รู้จักกันดี

ประเภทการติดตาม ชื่อแทร็กเริ่มต้น
การผลิต การถ่ายทำ
การทดสอบแบบเปิด เบต้า
การทดสอบภายใน qa

ชื่อแทร็กสำหรับแทร็กรูปแบบของอุปกรณ์หนึ่งๆ สามารถคำนวณได้ดังนี้ "[prefix]:defaultTrackName" ตัวอย่างเช่น รูปแบบของอุปกรณ์ Wear OS จะมีแทร็กที่มีชื่อดังนี้ "wear:production", "wear:beta" และ "wear:qa"

แทร็กทดสอบแบบปิดสร้างขึ้นด้วยตนเองและมี ดังนั้นแทร็กทดสอบแบบปิดสำหรับรูปแบบของอุปกรณ์ที่ชื่อว่า $name จะมีชื่อแทร็กเป็น "[prefix]:$name"

ตัวอย่างเวิร์กโฟลว์ APK

ส่วนนี้อธิบายถึงวิธีการใช้งานโดยทั่วไปของ Track API ในกรณีนี้ เราสันนิษฐานว่าคุณต้องการอัปโหลด APK เวอร์ชันใหม่สำหรับแต่ละแทร็กและกำหนด ผู้ใช้จำนวนหนึ่งที่จะได้รับเวอร์ชันการเปิดตัวแบบทีละขั้น (ในทางปฏิบัติ นักพัฒนาซอฟต์แวร์ จะไม่มีแนวโน้มที่จะดำเนินการทั้งหมดนี้ในการดำเนินการเดียวกัน แทน คุณอาจต้องอัปเดตรุ่นเบต้าหนึ่งวัน สร้างการเปิดตัวแบบทีละขั้น "การผลิต" ในอีกวันหนึ่งเป็นต้น)

  1. เปิดการแก้ไขใหม่ ตามที่อธิบายไว้ใน เวิร์กโฟลว์การแก้ไข
  2. เรียกเมธอด Edits.apks: upload สำหรับ APK แต่ละรายการที่คุณต้องการอัปโหลด ส่ง APK ในคำขอของเมธอด เนื้อความ (การดำเนินการนี้จะวาง APK ไว้ในพื้นที่เก็บข้อมูล แต่ไม่ได้เผยแพร่ ลงในแทร็กหรือทำให้ใช้งานได้) เมธอดจะแสดงรหัสเวอร์ชันสำหรับ APK แต่ละรายการที่คุณอัปโหลด คุณจะใช้รหัสเวอร์ชันนี้เพื่ออ้างอิง ไปยัง APK เมื่อคุณเผยแพร่ในแทร็ก
  3. เรียกเมธอด Edits.tracks: update สำหรับแต่ละแทร็กที่คุณต้องการเผยแพร่ APK ในเนื้อหาคำขอ ส่งทรัพยากร Edits.tracks ที่มีรุ่นที่คุณต้องการเปิดตัว ตัวอย่างเช่น หากต้องการเปิดตัว APK ที่มีรหัสเวอร์ชัน 88:

    {
    "releases": [{
      "versionCodes": ["88"],
      "status": "completed"
    }]
    }
    

    ขณะนี้ APK ยังไม่พร้อมใช้งานสำหรับผู้ใช้ เช่นเดียวกับ การแก้ไขอื่นๆ การเปลี่ยนแปลงจะไม่มีผลจนกว่าคุณจะยืนยัน

  4. เรียกเมธอดการแก้ไข: คอมมิตเพื่อ ทำการเปลี่ยนแปลง เมื่อดำเนินการแล้ว ผู้ใช้ในแต่ละแทร็กจะ ใน APK เวอร์ชันที่อัปเดตแล้ว (เช่นเดียวกับการแก้ไขทั้งหมด ตัวแปรสามารถ อาจใช้เวลาหลายชั่วโมงก่อนที่การเปลี่ยนแปลงจะมีผล)

การเปิดตัวแบบทีละขั้น

เมื่อคุณมี APK เวอร์ชันใหม่ที่ต้องการทยอยนำไปใช้ คุณอาจ เลือกเผยแพร่เป็น "การเปิดตัวแบบทีละขั้น" เวอร์ชัน หากคุณทำเช่นนี้ Google Play จะทำให้ใช้งานได้โดยอัตโนมัติตามสัดส่วนแอป ผู้ใช้ที่คุณระบุ หากปุ่ม "การเปิดตัว" APK ไม่มีปัญหาใดๆ (เช่น ฯลฯ) คุณอาจเพิ่มสัดส่วนของผู้ใช้ที่ได้รับ version; เมื่อคุณพร้อม คุณสามารถทำให้ APK นั้นเป็นเวอร์ชันที่ใช้งานจริงใหม่ เวอร์ชัน

ส่วนนี้จะอธิบายขั้นตอนที่คุณจะใช้ การเปิดตัว APK แบบทีละขั้น จากนั้นโปรโมตเวอร์ชันที่ใช้งานจริง

  1. สร้างการแก้ไขตามที่อธิบายไว้ในขั้นตอนการแก้ไข

  2. อัปโหลด APK ใหม่เพื่อแก้ไข โดยใช้ วิธี Edits.apks: อัปโหลด

  3. เริ่มการเผยแพร่ "inProgress" แบบทีละขั้นในแทร็กเวอร์ชันที่ใช้งานจริงโดยใช้ เมธอด Edits.tracks: update เลือก ของผู้ใช้บางส่วนที่ควรได้รับ APK ใหม่ ในตอนนี้ APK ไม่พร้อมใช้งานสำหรับผู้ใช้ปลายทาง

    {
    "releases": [{
      "versionCodes": ["99"],
      "userFraction": 0.05,
      "status": "inProgress"
    }]
    }
    

  4. ยืนยันการเปลี่ยนแปลงในการแก้ไขที่ดำเนินอยู่โดยการเรียกใช้ การแก้ไข: คอมมิต ในอีก 2-3 ปีข้างหน้า APK ใหม่จะเปิดตัวแก่ผู้ใช้ เศษส่วน ของผู้ใช้ที่คุณเลือกจะได้รับ APK ใหม่

จากนั้น คุณอาจต้องการเพิ่มจำนวน เปอร์เซ็นต์ของผู้ใช้ที่มีสิทธิ์สำหรับรุ่นนั้นหรือหยุดรุ่นนั้นๆ

การเพิ่มสัดส่วนผู้ใช้สำหรับการเปิดตัวแบบทีละขั้น

สมมติว่าคุณมีการเปิดตัวแบบทีละขั้นที่ 5% ตามที่อธิบายไว้ก่อนหน้านี้ ส่วนนี้อธิบายถึงวิธีการเพิ่มเปอร์เซ็นต์ในกรณี การเปิดตัวผลงานเป็นไปในทิศทางใด

  1. สร้างการแก้ไขตามที่อธิบายไว้ในขั้นตอนการแก้ไข

  2. เปลี่ยนรุ่นแบบทีละขั้น "inProgress" ในแทร็กเวอร์ชันที่ใช้งานจริงโดยใช้ เมธอด Edits.tracks: update เพิ่ม สัดส่วนของผู้ใช้ที่ควรได้รับ APK ใหม่:

    {
    "releases": [{
      "versionCodes": ["99"],
      "userFraction": 0.1,
      "status": "inProgress"
    }]
    }
    

  3. ยืนยันการเปลี่ยนแปลงในการแก้ไขที่ดำเนินอยู่โดยการเรียกใช้ การแก้ไข: คอมมิต ในอีก 2-3 ปีข้างหน้า APK ใหม่จะเปิดตัวแก่ผู้ใช้ เศษส่วน ของผู้ใช้ที่คุณเลือกจะได้รับ APK ใหม่

การหยุดการเปิดตัวแบบทีละขั้น

สมมติว่าคุณมีการเปิดตัวแบบทีละขั้นที่ 5% ตามที่อธิบายไว้ก่อนหน้านี้ ส่วนนี้อธิบายถึงวิธีหยุดการเปิดตัวแบบทีละขั้นในกรณีที่ เมื่อคุณพบปัญหา

  1. สร้างการแก้ไขตามที่อธิบายไว้ในขั้นตอนการแก้ไข

  2. เปลี่ยนรุ่นแบบทีละขั้น "inProgress" ในแทร็กเวอร์ชันที่ใช้งานจริงโดยใช้ เมธอด Edits.tracks: update ตั้งค่า สถานะเป็น "halted"

    {
    "releases": [{
      "versionCodes": ["99"],
      "status": "halted"
    }]
    }
    

  3. ยืนยันการเปลี่ยนแปลงในการแก้ไขที่ดำเนินอยู่โดยการเรียกใช้ การแก้ไข: คอมมิต รุ่นที่เผยแพร่จะไม่สามารถใช้งานได้อีกต่อไป พร้อมใช้งานสำหรับผู้ใช้ใหม่

หากภายหลังคุณตัดสินใจกลับมาใช้รุ่นที่ถูกระงับไปแล้วอีกครั้ง ก็สามารถทำได้โดยการตั้งค่า สถานะกลับเป็น "inProgress"

การเสร็จสิ้นการเปิดตัวแบบทีละขั้น

เมื่อพอใจกับการเปิดตัวแบบทีละขั้นแล้ว และต้องการเปิดตัวรุ่นไปยัง ผู้ใช้ทั้ง 100% คุณตั้งค่าสถานะรุ่นเป็น "completed" ได้ ดังนี้

  1. สร้างการแก้ไขตามที่อธิบายไว้ในขั้นตอนการแก้ไข

  2. เปลี่ยนรุ่นแบบทีละขั้น "inProgress" ในแทร็กเวอร์ชันที่ใช้งานจริงโดยใช้ เมธอด Edits.tracks: update ตั้งค่า สถานะเป็น "completed"

    {
    "releases": [{
      "versionCodes": ["99"],
      "status": "completed"
    }]
    }
    

  3. ยืนยันการเปลี่ยนแปลงในการแก้ไขที่ดำเนินอยู่โดยการเรียกใช้ การแก้ไข: คอมมิต ในอีก 2-3 ปีข้างหน้า APK ใหม่จะเปิดตัวแก่ผู้ใช้ เศษส่วน ของผู้ใช้ที่คุณเลือกจะได้รับ APK ใหม่

เวอร์ชันร่าง

เวอร์ชันร่างช่วยให้คุณอัปโหลด APK โดยอัตโนมัติและสร้างรุ่นผ่าน API ซึ่งสามารถติดตั้งใช้งานผ่าน Google Play Console ในภายหลังได้ ถึง สร้างเวอร์ชันร่างในแทร็ก

  1. เปิดการแก้ไขใหม่ ตามที่อธิบายไว้ใน เวิร์กโฟลว์การแก้ไข
  2. เรียกเมธอด Edits.apks: upload สำหรับ APK แต่ละรายการที่คุณต้องการอัปโหลด ส่ง APK ในเนื้อหาคำขอของเมธอด จะแสดงรหัสเวอร์ชันสำหรับ APK แต่ละรายการที่คุณอัปโหลด คุณจะใช้สิ่งนี้ รหัสเวอร์ชันเพื่ออ้างถึง APK เมื่อคุณมอบหมายให้กับรุ่น
  3. เรียกเมธอด Edits.tracks: update สำหรับแต่ละแทร็ก ที่คุณต้องการเผยแพร่ ในเนื้อหาคำขอ ส่งทรัพยากร Edits.tracks ที่มีเวอร์ชันร่างที่คุณต้องการสร้าง ดังตัวอย่างต่อไปนี้

    {
    "releases": [{
      "name": "My draft release",
      "versionCodes": ["88"],
      "status": "draft"
    }]
    }
    

  4. เรียกเมธอดการแก้ไข: คอมมิตเพื่อ ทำการเปลี่ยนแปลง ตอนนี้คุณสามารถตรวจสอบและเปิดตัวเวอร์ชันร่างได้แล้ว ผ่าน Google Play Console หรือ API

การระบุบันทึกประจำรุ่น

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

โดยใช้ฟิลด์ "releaseNotes" เมื่อใส่ ทรัพยากร Edits.tracks ไปยัง เมธอด Edits.tracks: อัปเดต

{
  "releases": [{
      "name": "Release with notes",
      "versionCodes": ["88"],
      "status": "completed",
      "releaseNotes": [
        {"language": "en-US", "text": "Describe what's new in this release."}
      ]
  }]
}