ประกาศความต้องการด้านระดับการเข้าถึงแพ็กเกจ

ขณะสร้างแอป คุณควรพิจารณาแอปอื่นๆ ในอุปกรณ์ที่แอปของคุณต้องโต้ตอบด้วย หากแอปกำหนดเป้าหมายเป็น Android 11 (API ระดับ 30) ขึ้นไป ระบบจะทำให้แอปบางแอปแสดงในแอปของคุณโดยอัตโนมัติ แต่ระบบจะกรองแอปอื่นๆ ออกโดยค่าเริ่มต้น คู่มือนี้จะอธิบายวิธีทําให้แอปอื่นๆ เหล่านั้นมองเห็นแอปของคุณ

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

ชื่อแพ็กเกจที่เฉพาะเจาะจง

หากคุณทราบแอปเฉพาะที่คุณต้องการค้นหาหรือโต้ตอบด้วย เช่น แอปที่ผสานรวมกับแอปพลิเคชันของคุณ หรือแอปที่คุณให้บริการ รวมถึงแอปพลิเคชัน ชื่อแพ็กเกจในชุด <package> ภายในเอลิเมนต์ <queries> ได้แก่

<manifest package="com.example.game">
    <queries>
        <package android:name="com.example.store" />
        <package android:name="com.example.services" />
    </queries>
    ...
</manifest>

หมายเหตุ: หากคุณประกาศองค์ประกอบ <package> ในไฟล์ Manifest ของแอป แอปที่เชื่อมโยงกับชื่อแพ็กเกจนั้นจะปรากฏในผลการค้นหาของข้อความค้นหา PackageManager ที่ตรงกับคอมโพเนนต์จากแอปนั้น

สื่อสารกับแอปโฮสต์ในคลัง

หากคุณพัฒนาไลบรารี Android คุณก็ประกาศความต้องการด้านระดับการมองเห็นแพ็กเกจได้ โดยเพิ่มองค์ประกอบ <queries> ในไฟล์ Manifest AAR องค์ประกอบ <queries> นี้มี เป็นองค์ประกอบที่แอปประกาศในไฟล์ Manifest ได้

ถ้าไลบรารีของคุณมีการสื่อสารกับแอปโฮสต์ เช่น การใช้ bound service [บริการ] ให้ใส่เอลิเมนต์ <package> ที่ ระบุชื่อแพ็กเกจของแอปโฮสต์ ดังนี้

<!-- Place inside the <queries> element. -->
<package android:name=PACKAGE_NAME />

การรวมการประกาศนี้จะทําให้ตรวจสอบได้ว่ามีการติดตั้งแอปโฮสต์ไว้แล้วหรือไม่ และ โต้ตอบกับแอป เช่น การโทร bindService() แอปการโทรที่ใช้คลังจะเปลี่ยนโดยอัตโนมัติ แสดงกับแอปโฮสต์ อันเนื่องมาจาก การโต้ตอบนี้

แพ็กเกจที่ตรงกับลายเซ็นของตัวกรอง Intent

แอปของคุณอาจต้องค้นหาหรือโต้ตอบกับชุดแอปที่มีวัตถุประสงค์เฉพาะ แต่คุณอาจไม่ทราบชื่อแพ็กเกจที่เฉพาะเจาะจงที่จะรวมไว้ ในสถานการณ์เช่นนี้ คุณสามารถแสดงรายการ ลายเซ็นตัวกรองความตั้งใจในไฟล์ องค์ประกอบ <queries> จากนั้นแอปจะค้นพบแอปที่มีองค์ประกอบ<intent-filter>ตรงกัน

ตัวอย่างโค้ดต่อไปนี้แสดงองค์ประกอบ <intent> ที่จะอนุญาตให้แอปเห็นแอปอื่นๆ ที่ติดตั้งไว้ซึ่งรองรับการแชร์รูปภาพ JPEG

<manifest package="com.example.game">
    <queries>
        <intent>
            <action android:name="android.intent.action.SEND" />
            <data android:mimeType="image/jpeg" />
        </intent>
    </queries>
    ...
</manifest>

องค์ประกอบ <intent> มีข้อจำกัดบางอย่างดังนี้

• คุณต้องรวมองค์ประกอบ <action> เพียง 1 รายการเท่านั้น
• คุณใช้แอตทริบิวต์ path, pathPrefix, pathPattern หรือ port ไม่ได้ ในเอลิเมนต์ <data> ระบบจะทำงานเสมือนว่าคุณกำหนดค่าของแอตทริบิวต์แต่ละรายการ เป็นอักขระไวลด์การ์ดทั่วไป (*)
• คุณใช้แอตทริบิวต์ mimeGroup ขององค์ประกอบ <data> ไม่ได้

• คุณใช้แอตทริบิวต์ต่อไปนี้ได้สูงสุดครั้งเดียวภายในองค์ประกอบ <data> ขององค์ประกอบ <intent> รายการเดียว

  • mimeType
  • scheme
  • host

  คุณจะกระจายแอตทริบิวต์เหล่านี้ในองค์ประกอบ <data> หลายรายการหรือใช้ ไว้ในองค์ประกอบ <data> เดียว

องค์ประกอบ <intent> รองรับอักขระไวลด์การ์ดทั่วไป (*) เป็น ค่าสำหรับแอตทริบิวต์บางรายการ

• แอตทริบิวต์ name ขององค์ประกอบ <action>
• ประเภทย่อยของแอตทริบิวต์ mimeType ขององค์ประกอบ <data> (image/*)
• ประเภทและแอตทริบิวต์ย่อยของแอตทริบิวต์ mimeType ขององค์ประกอบ <data> (*/*)
• แอตทริบิวต์ scheme ขององค์ประกอบ <data>
• แอตทริบิวต์ host ขององค์ประกอบ <data>

หากไม่ได้ระบุไว้เป็นอย่างอื่นในรายการก่อนหน้านี้ ระบบไม่สนับสนุน ชุดข้อความและอักขระไวลด์การ์ด เช่น prefix*

แพ็กเกจที่ใช้หน่วยงานเฉพาะ

หากต้องการค้นหาผู้ให้บริการเนื้อหาแต่ไม่ทราบชื่อแพ็กเกจที่เฉพาะเจาะจง คุณสามารถประกาศสิทธิ์ของผู้ให้บริการในองค์ประกอบ <provider> ตามที่แสดงในข้อมูลโค้ดต่อไปนี้

<manifest package="com.example.suite.enterprise">
    <queries>
        <provider android:authorities="com.example.settings.files" />
    </queries>
    ...
</manifest>

หมายเหตุ: หากองค์ประกอบ <queries> มีองค์ประกอบ <provider> คุณอาจเห็น คำเตือนของเอดิเตอร์ใน Android Studio ที่เกี่ยวข้องกับองค์ประกอบ <provider> นาน เมื่อคุณใช้ปลั๊กอิน Android Gradle รุ่นล่าสุด จะไม่ได้รับผลกระทบ คุณจึงเพิกเฉยต่อคำเตือนได้ ดูข้อมูลเพิ่มเติมในบล็อก โพสต์เกี่ยวกับการเตรียมบิลด์ Gradle สำหรับระดับการเข้าถึงแพ็กเกจใน Android 11

คุณประกาศหน่วยงานผู้ให้บริการในองค์ประกอบ <queries> เดียวกันได้ ภายใน <queries> องค์ประกอบ คุณประกาศองค์ประกอบ <provider> ได้อย่างน้อย 1 รายการ องค์ประกอบ <provider> สามารถมีหน่วยงานของผู้ให้บริการเพียงหน่วยงานเดียวหรือรายการหน่วยงานของผู้ให้บริการที่คั่นด้วยเซมิโคลอน

แอปทั้งหมด (ไม่แนะนำ)

ในบางกรณีที่เกิดขึ้นไม่บ่อยนัก แอปของคุณอาจต้องค้นหาหรือโต้ตอบกับแอปที่ติดตั้งทั้งหมดในอุปกรณ์ โดยไม่คำนึงถึงคอมโพเนนต์ที่มี หากต้องการอนุญาตให้แอป ดูแอปที่ติดตั้งอื่นๆ ทั้งหมด ระบบจะให้ QUERY_ALL_PACKAGES สิทธิ์

ตัวอย่างกรณีการใช้งานที่ สิทธิ์ QUERY_ALL_PACKAGES มีความเหมาะสมที่จะรวมไว้ ได้แก่

• แอปการช่วยเหลือพิเศษ
• เบราว์เซอร์
• แอปการจัดการอุปกรณ์
• แอปความปลอดภัย
• แอปป้องกันไวรัส

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

การปรับปรุงนโยบายนี้จาก Google เล่น มีหลักเกณฑ์สำหรับแอปที่ต้องมีสิทธิ์QUERY_ALL_PACKAGES