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

ขณะสร้างแอป คุณควรพิจารณาแอปอื่นๆ ในอุปกรณ์ที่แอปของคุณต้องโต้ตอบด้วย หากแอปกำหนดเป้าหมายเป็น 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>

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

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

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

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

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

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

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

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

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

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

ตัวอย่างกรณีการใช้งานที่ควรระบุสิทธิ์ QUERY_ALL_PACKAGES

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

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

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