ประกาศสิทธิ์ของแอป

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

ขั้นตอนการขอสิทธิ์จะขึ้นอยู่กับประเภทของสิทธิ์ ดังนี้

เพิ่มการประกาศลงในไฟล์ Manifest ของแอป

หากต้องการประกาศสิทธิ์ที่แอปอาจขอ ให้ใส่เอลิเมนต์ <uses-permission> ที่เหมาะสมในไฟล์ Manifest ของแอป ตัวอย่างเช่น แอปที่ต้องเข้าถึงกล้องจะมีบรรทัดนี้ใน AndroidManifest.xml:

<manifest ...>
    <uses-permission android:name="android.permission.CAMERA"/>
    <application ...>
        ...
    </application>
</manifest>

ประกาศฮาร์ดแวร์เป็นแบบไม่บังคับ

สิทธิ์บางอย่าง เช่น CAMERA ช่วยให้แอปเข้าถึงฮาร์ดแวร์บางส่วนที่มีเฉพาะในอุปกรณ์ Android บางรุ่นเท่านั้น หากแอปของคุณประกาศสิทธิ์ที่เชื่อมโยงกับฮาร์ดแวร์อย่างใดอย่างหนึ่งเหล่านี้ ให้พิจารณาว่าแอปจะยังทำงานในอุปกรณ์ที่ไม่มีฮาร์ดแวร์ดังกล่าวได้หรือไม่ ในกรณีส่วนใหญ่ ฮาร์ดแวร์เป็นแบบไม่บังคับ ดังนั้นจึงควรประกาศฮาร์ดแวร์เป็นแบบไม่บังคับโดยตั้งค่า android:required เป็น false ในการประกาศ <uses-feature> ดังที่แสดงในข้อมูลโค้ดต่อไปนี้จากไฟล์ AndroidManifest.xml

<manifest ...>
    <application>
        ...
    </application>
    <uses-feature android:name="android.hardware.camera"
                  android:required="false" />
<manifest>

ตรวจสอบความพร้อมใช้งานของฮาร์ดแวร์

หากคุณประกาศว่าฮาร์ดแวร์เป็นแบบไม่บังคับ แอปอาจทำงานในอุปกรณ์ที่ไม่มีฮาร์ดแวร์นั้นได้ หากต้องการตรวจสอบว่าอุปกรณ์มีฮาร์ดแวร์ที่เฉพาะเจาะจงหรือไม่ ให้ใช้เมธอด hasSystemFeature() ดังที่แสดงในข้อมูลโค้ดต่อไปนี้ หากฮาร์ดแวร์ไม่พร้อมใช้งาน ให้ปิดใช้ฟีเจอร์นั้นในแอปอย่างเหมาะสม

Kotlin

// Check whether your app is running on a device that has a front-facing camera.
if (applicationContext.packageManager.hasSystemFeature(
        PackageManager.FEATURE_CAMERA_FRONT)) {
    // Continue with the part of your app's workflow that requires a
    // front-facing camera.
} else {
    // Gracefully degrade your app experience.
}

Java

// Check whether your app is running on a device that has a front-facing camera.
if (getApplicationContext().getPackageManager().hasSystemFeature(
        PackageManager.FEATURE_CAMERA_FRONT)) {
    // Continue with the part of your app's workflow that requires a
    // front-facing camera.
} else {
    // Gracefully degrade your app experience.
}

ประกาศสิทธิ์ตามระดับ API

หากต้องการประกาศสิทธิ์เฉพาะในอุปกรณ์ที่รองรับสิทธิ์รันไทม์ ซึ่งก็คืออุปกรณ์ที่ใช้ Android 6.0 (ระดับ API 23) ขึ้นไป ให้ใส่องค์ประกอบ <uses-permission-sdk-23> แทนองค์ประกอบ <uses-permission>

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

ตัวอย่างเช่น แอปอาจแสดงเนื้อหาสื่อ เช่น รูปภาพหรือวิดีโอที่ผู้ใช้สร้างขึ้นขณะอยู่ในแอป ในกรณีนี้ คุณไม่จำเป็นต้องใช้สิทธิ์ READ_EXTERNAL_STORAGE ในอุปกรณ์ที่ใช้ Android 10 (API ระดับ 29) ขึ้นไป ตราบใดที่แอปกำหนดเป้าหมายเป็น Android 10 ขึ้นไป อย่างไรก็ตาม เพื่อให้เข้ากันได้กับอุปกรณ์รุ่นเก่า คุณสามารถประกาศสิทธิ์ READ_EXTERNAL_STORAGE และตั้งค่า android:maxSdkVersion เป็น 28 ได้