ตั้งแต่วันที่ 27 มีนาคม 2025 เป็นต้นไป เราขอแนะนำให้ใช้ android-latest-release แทน aosp-main เพื่อสร้างและมีส่วนร่วมใน AOSP โปรดดูข้อมูลเพิ่มเติมที่หัวข้อการเปลี่ยนแปลงใน AOSP

หน้านี้ได้รับการแปลโดย Cloud Translation API

ประกาศ Flag aconfig

คุณสามารถใช้ Flag aconfig ในโค้ด Java, C, C++ และ Rust ระบบบิลด์ AOSP จะเปิดเครื่องมือชื่อ aconfig ซึ่งใช้สร้างคลังเมธอดเฉพาะภาษาที่คุณสามารถใช้เข้าถึงค่าของ Flag แต่ละรายการ คุณต้องประกาศ Flag และเพิ่มลงในบิลด์ก่อนจึงจะสร้างไลบรารีได้

ประกาศ Flag aconfig สําหรับ Java

วิธีประกาศ Flag aconfig สำหรับ Java

ในไดเรกทอรีที่มีโค้ดใหม่ ให้สร้างไฟล์ที่มีนามสกุล .aconfig เช่น my_new_aconfig_flag_declarations.aconfig ไฟล์ aconfig คือไฟล์โปรโตคอลข้อความที่เป็นไปตามสคีมามาตรฐาน
เพิ่มการประกาศ Flag คล้ายกับตัวอย่างต่อไปนี้
```
package: "com.example.android.aconfig.demo.flags"
container: "system"

flag {
    name: "my_new_flag"
    namespace: "aconfig_demo_namespace"
    description: "This flag controls untested code"
    bug: "<none>"
}
```
สถานที่:
- package เมื่อรวมกับชื่อ Flag จะให้คีย์ที่ไม่ซ้ำกัน ใน Java การกําหนด package เป็น foo.bar จะทําให้คลาสชื่อ foo.bar.Flags สร้างขึ้นโดยอัตโนมัติ ใน C++ เมธอดการเข้าถึง Flag จะตั้งชื่อว่า foo::bar::"flagname" Flag ในไฟล์ประกาศเดียวกันจะอยู่ในแพ็กเกจเดียวกัน แต่ไฟล์ประกาศหลายไฟล์สามารถส่ง Flag ไปยังแพ็กเกจเดียวกันได้
- container กำหนดคอลเล็กชันโค้ดที่สร้างและจัดส่งร่วมกันในรูปแบบไบนารี คอนเทนเนอร์ที่ใช้ได้คือ system, vendor, system_ext, product, name.of.apex และ name.of.apk
- name มีชื่อของ Flag ที่มีเฉพาะตัวอักษรพิมพ์เล็ก ขีดล่าง และตัวเลขเท่านั้น
- namespace มีเนมสเปซสำหรับการมีส่วนร่วม คุณต้องทํางานร่วมกับผู้ตรวจสอบของ Google ที่ได้รับมอบหมายเพื่อกําหนดเนมสเปซ หากใช้ฟีเจอร์แฟล็กการเปิดตัวเพื่อรักษาเสถียรภาพของมิเรอร์ AOSP ของคุณเอง คุณจะใช้เนมสเปซใดก็ได้ตามต้องการ
- description มีคำอธิบายสั้นๆ เกี่ยวกับฟีเจอร์หรือการเปลี่ยนแปลงที่มีการแจ้งว่าไม่เหมาะสม
- bug คือหมายเลขข้อบกพร่องที่เชื่อมโยงกับการมีส่วนร่วมของโค้ดใหม่ คุณต้องทำงานร่วมกับผู้ตรวจสอบของ Google ที่ได้รับมอบหมายเพื่อกำหนดbug หากคุณใช้ Flag การเปิดตัวฟีเจอร์เพื่อรักษาเสถียรภาพของมิเรอร์ AOSP ของคุณเอง ให้ใช้หมายเลขติดตามข้อบกพร่องหรือใช้ <none>
หมายเหตุ: ระบบไม่รองรับการใช้ Flag ใน APK ที่ไม่ได้สร้างด้วย APEX หรือพาร์ติชันระบบ
บันทึกไฟล์และออกจากเครื่องมือแก้ไข

ตั้งค่าบิลด์

หลังจากประกาศ Flag แล้ว ให้ตั้งค่าบิลด์เพื่อให้สร้างโค้ดไลบรารีที่ใช้เข้าถึงค่าของ Flag ได้

ในไฟล์บิลด์ Android.bp ให้เพิ่มส่วน aconfig_declarations คล้ายกับตัวอย่างต่อไปนี้
```
aconfig_declarations {
  name: "aconfig_demo_flags",
  package: "com.example.android.aconfig.demo.flags",
  srcs: [
    "my_new_aconfig_flag_declarations.aconfig"
  ],
}
```
สถานที่:
- name มีชื่อประกาศที่มีเฉพาะตัวอักษรพิมพ์เล็ก ขีดล่าง และตัวเลขเท่านั้น
- package มีชื่อแพ็กเกจเดียวกับที่ใช้ในการประกาศ
- srcs มีชื่อไฟล์ .aconfig ที่ประกาศ Flag
บันทึกไฟล์และออกจากเครื่องมือแก้ไข

ประกาศ Flag aconfig สําหรับ C และ C++

วิธีประกาศ Flag aconfig สําหรับ C และ C++

ในไดเรกทอรีที่มีโค้ดใหม่ ให้สร้างไฟล์ที่มีนามสกุล .aconfig เช่น my_new_aconfig_flag_declarations.aconfig ไฟล์ aconfig คือไฟล์โปรโตคอลข้อความที่เป็นไปตามสคีมามาตรฐาน
เพิ่มการประกาศ Flag คล้ายกับตัวอย่างต่อไปนี้
```
package: "com.example.android.aconfig.demo.flags"
container: "system"

flag {
    name: "my_new_flag"
    namespace: "aconfig_demo_namespace"
    description: "This flag controls untested code"
    bug: "<none>"
}
```
สถานที่:
- package เมื่อรวมกับชื่อ Flag จะให้คีย์ที่ไม่ซ้ำกัน ใน Java การกําหนด package เป็น foo.bar จะทําให้คลาสชื่อ foo.bar.Flags สร้างขึ้นโดยอัตโนมัติ ใน C++ เมธอดการเข้าถึง Flag จะตั้งชื่อว่า foo::bar::"flagname" Flag ในไฟล์ประกาศเดียวกันจะอยู่ในแพ็กเกจเดียวกัน แต่ไฟล์ประกาศหลายไฟล์สามารถส่ง Flag ไปยังแพ็กเกจเดียวกันได้
- container กำหนดคอลเล็กชันโค้ดที่สร้างและจัดส่งร่วมกันในรูปแบบไบนารี คอนเทนเนอร์ที่ใช้ได้คือ system, vendor, system_ext, product, name.of.apex และ name.of.apk
- name มีชื่อของ Flag ที่มีเฉพาะตัวอักษรพิมพ์เล็ก ขีดล่าง และตัวเลขเท่านั้น
- namespace มีเนมสเปซสำหรับการมีส่วนร่วม คุณต้องทํางานร่วมกับผู้ตรวจสอบของ Google ที่ได้รับมอบหมายเพื่อกําหนดเนมสเปซ หากใช้ฟีเจอร์แฟล็กการเปิดตัวเพื่อรักษาเสถียรภาพของมิเรอร์ AOSP ของคุณเอง คุณจะใช้เนมสเปซใดก็ได้ตามต้องการ
- description มีคำอธิบายสั้นๆ เกี่ยวกับฟีเจอร์หรือการเปลี่ยนแปลงที่มีการแจ้งว่าไม่เหมาะสม
- bug คือหมายเลขข้อบกพร่องที่เชื่อมโยงกับการมีส่วนร่วมของโค้ดใหม่ คุณต้องทำงานร่วมกับผู้ตรวจสอบของ Google ที่ได้รับมอบหมายเพื่อกำหนดbug หากคุณใช้ Flag การเปิดตัวฟีเจอร์เพื่อรักษาเสถียรภาพของมิเรอร์ AOSP ของคุณเอง ให้ใช้หมายเลขติดตามข้อบกพร่องหรือใช้ <none>
หมายเหตุ: ระบบไม่รองรับการใช้ Flag ใน APK ที่ไม่ได้สร้างด้วย APEX หรือพาร์ติชันระบบ
บันทึกไฟล์และออกจากเครื่องมือแก้ไข

ตั้งค่าบิลด์

ในไฟล์บิลด์ Android.bp ให้เพิ่มส่วน aconfig_declarations คล้ายกับตัวอย่างต่อไปนี้
```
aconfig_declarations {
  name: "aconfig_demo_flags",
  package: "com.example.android.aconfig.demo.flags",
  srcs: [
    "my_new_aconfig_flag_declarations.aconfig"
  ],
}
```
สถานที่:
- name มีชื่อประกาศที่มีเฉพาะตัวอักษรพิมพ์เล็ก ขีดล่าง และตัวเลขเท่านั้น
- package มีชื่อแพ็กเกจเดียวกับที่ใช้ในการประกาศ
- srcs มีชื่อไฟล์ aconfig ที่ประกาศ Flag
ในไฟล์เดียวกัน ให้สร้างเป้าหมาย cc_aconfig_library ที่คล้ายกับตัวอย่างต่อไปนี้
```
cc_aconfig_library {
    name: "aconfig_demo_flags_c_lib",
    aconfig_declarations: "aconfig_demo_flags",
}
```
สถานที่:
- name มีชื่อคลังที่มีเฉพาะตัวอักษรพิมพ์เล็ก ขีดล่าง และตัวเลขเท่านั้น
- aconfig_declarations มี name เดียวกันกับที่ใช้ในการประกาศ
เป้าหมายการสร้าง cc_aconfig_library จะเรียกใช้ Codegen ของ C หรือ C++ ซึ่งจะสร้างไลบรารีที่มีโค้ดที่สร้างขึ้น ณ เวลาที่สร้าง

คลัง aconfig ของ CC คล้ายกับเป้าหมายคลัง CC แต่มีตัวเลือก เช่น vendor_available, product_available, host_supported และ vndk หากเป้าหมายการสร้างที่ขึ้นอยู่กับ cc_aconfig_library นี้ต้องใช้ตัวแปรบางประเภท คุณอาจต้องเพิ่มการตั้งค่าที่เกี่ยวข้องในเป้าหมายคลัง aconfig ของ CC ด้วย เช่น หากเป้าหมายการสร้างระดับบนสุดมีการตั้งค่า vendor_available เป็น true คุณอาจต้องตั้งค่า vendor_available เป็น true ในเป้าหมาย cc_aconfig_library นี้ด้วย

หลังจากเพิ่มเป้าหมายการสร้างนี้แล้ว โค้ดของคุณจะเข้าถึงไลบรารีนี้ได้ คุณรวมไลบรารีนี้โดยใช้ไวยากรณ์ static_lib หรือ shared_lib ได้ โปรดทราบว่าหากต้องการเพิ่มไลบรารีนี้เป็น static_lib ให้เพิ่มการพึ่งพา shared_lib ใน server_configurable_flags ขั้นตอนที่ 3 จะแสดงวิธีรวมไลบรารี Flag ที่สร้างขึ้นจากโค้ดลงในlibexample_cpp_lib
สร้างเป้าหมายที่ใช้ Flag aconfig เช่นตัวอย่างต่อไปนี้ cc_library
```
cc_library {
    name: "libexample_cpp_lib",
    srcs: ["src/example_cpp_lib.cc"],
    double_loadable: true,
    cflags: [
        "-Wall",
        "-Werror",
        "-Wno-unused-function",
        "-Wno-unused-parameter",
    ],
    header_libs: [
        "jni_headers",
    ],
    shared_libs: [
        "server_configurable_flags",
    ],
    static_libs: [
        "aconfig_demo_flags_c_lib",
    ],
    export_include_dirs: ["src/include"],
}
```
สถานที่:
- shared_libs มีไลบรารีเพิ่มเติมที่จําเป็นสําหรับ Flag aconfig
- static_libs คือชื่อไลบรารีที่สร้างโดยบิลด์ตามช่อง cc_aconfig_library name ในขั้นตอนที่ 2 การสร้างรายการ cc_library ที่มีชื่อไลบรารีแบบคงที่จะช่วยให้คุณใช้ Flag aconfig ในโค้ดได้

ประกาศ Flag aconfig สําหรับ Rust

วิธีประกาศ Flag aconfig สำหรับ Rust

ในไดเรกทอรีที่มีโค้ดใหม่ ให้สร้างไฟล์ที่มีนามสกุล .aconfig เช่น my_new_aconfig_flag_declarations.aconfig ไฟล์ aconfig คือไฟล์โปรโตคอลข้อความที่เป็นไปตามสคีมามาตรฐาน
เพิ่มการประกาศ Flag คล้ายกับตัวอย่างต่อไปนี้
```
package: "com.example.android.aconfig.demo.flags"
container: "system"

flag {
    name: "my_new_flag"
    namespace: "aconfig_demo_namespace"
    description: "This flag controls untested code"
    bug: "<none>"
}
```
สถานที่:
- package เมื่อรวมกับชื่อ Flag จะให้คีย์ที่ไม่ซ้ำกัน ใน Java การกําหนด package เป็น foo.bar จะทําให้คลาสชื่อ foo.bar.Flags สร้างขึ้นโดยอัตโนมัติ ใน C++ เมธอดการเข้าถึง Flag จะตั้งชื่อว่า foo::bar::"flagname" Flag ในไฟล์ประกาศเดียวกันจะอยู่ในแพ็กเกจเดียวกัน แต่ไฟล์ประกาศหลายไฟล์สามารถส่ง Flag ไปยังแพ็กเกจเดียวกันได้
- container กำหนดคอลเล็กชันโค้ดที่สร้างและจัดส่งร่วมกันในรูปแบบไบนารี คอนเทนเนอร์ที่ใช้ได้คือ system, vendor, system_ext, product, name.of.apex และ name.of.apk
- name มีชื่อของ Flag ที่มีเฉพาะตัวอักษรพิมพ์เล็ก ขีดล่าง และตัวเลขเท่านั้น
- namespace มีเนมสเปซสำหรับการมีส่วนร่วม คุณต้องทํางานร่วมกับผู้ตรวจสอบของ Google ที่ได้รับมอบหมายเพื่อกําหนดเนมสเปซ หากใช้ฟีเจอร์แฟล็กการเปิดตัวเพื่อรักษาเสถียรภาพของมิเรอร์ AOSP ของคุณเอง คุณจะใช้เนมสเปซใดก็ได้ตามต้องการ
- description มีคำอธิบายสั้นๆ เกี่ยวกับฟีเจอร์หรือการเปลี่ยนแปลงที่มีการแจ้งว่าไม่เหมาะสม
- bug คือหมายเลขข้อบกพร่องที่เชื่อมโยงกับการมีส่วนร่วมของโค้ดใหม่ คุณต้องทำงานร่วมกับผู้ตรวจสอบของ Google ที่ได้รับมอบหมายเพื่อกำหนดbug หากคุณใช้ Flag การเปิดตัวฟีเจอร์เพื่อรักษาเสถียรภาพของมิเรอร์ AOSP ของคุณเอง ให้ใช้หมายเลขติดตามข้อบกพร่องหรือใช้ <none>
หมายเหตุ: ระบบไม่รองรับการใช้ Flag ใน APK ที่ไม่ได้สร้างด้วย APEX หรือพาร์ติชันระบบ
บันทึกไฟล์และออกจากเครื่องมือแก้ไข

ตั้งค่าบิลด์

ในไฟล์บิลด์ Android.bp ให้เพิ่มส่วน aconfig_declarations คล้ายกับตัวอย่างต่อไปนี้
```
aconfig_declarations {
  name: "aconfig_demo_flags",
  package: "com.example.android.aconfig.demo.flags",
  srcs: [
    "my_new_aconfig_flag_declarations.aconfig"
  ],
}
```
สถานที่:
- name มีชื่อประกาศที่มีเฉพาะตัวอักษรพิมพ์เล็ก ขีดล่าง และตัวเลขเท่านั้น
- package มีชื่อแพ็กเกจเดียวกับที่ใช้ในการประกาศ
- srcs มีชื่อไฟล์ aconfig ที่ประกาศ Flag
สร้างเป้าหมาย rust_aconfig_library ที่คล้ายกับตัวอย่างถัดไป เป้าหมายนี้จะเรียกใช้ Rust Codegen และสร้างไลบรารี Rust ด้วยโค้ดที่สร้างขึ้นในระหว่างเวลาสร้าง
```
rust_aconfig_library {
  name: "libaconfig_demo_flags_rust",
  crate_name: "aconfig_demo_flags_rust",
  aconfig_declarations: "aconfig_demo_flags",
}
```
สถานที่:
- name มีชื่อประกาศที่มีเฉพาะตัวอักษรพิมพ์เล็ก ขีดล่าง และตัวเลขเท่านั้น
- crate_name มีชื่อแพ็กเกจเดียวกับที่ใช้ในการประกาศ
- aconfig_declarations มี name เดียวกันกับที่ใช้ในการประกาศ
การเปลี่ยนแปลงนี้จะช่วยให้โค้ดของคุณใช้คลัง Rust นี้ได้
ในไฟล์เดียวกัน ให้สร้างรายการ rust_library ที่คล้ายกับตัวอย่างต่อไปนี้
```
rust_library {
  name: "libexample_lib",
  rustlibs: [
      "libaconfig_demo_flags_rust",
  ]
}
```
ตัวอย่างนี้ช่วยให้เป้าหมายการสร้างซอร์สโค้ด libexample_demo_flags_rust รวมคลัง Flag ที่สร้างขึ้นจากโค้ดได้
บันทึกไฟล์และออกจากเครื่องมือแก้ไข