จัดการไฟล์ทั้งหมดในอุปกรณ์จัดเก็บข้อมูล

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

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

ขอสิทธิ์เข้าถึงไฟล์ทั้งหมด

แอปสามารถขอสิทธิ์เข้าถึงไฟล์ทั้งหมดจากผู้ใช้ได้โดยทำดังนี้

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

หากต้องการตรวจสอบว่าแอปของคุณได้รับสิทธิ์MANAGE_EXTERNAL_STORAGEหรือไม่ ให้โทรหา Environment.isExternalStorageManager()

การดำเนินการที่ MANAGE_EXTERNAL_STORAGE อนุญาต

สิทธิ์ MANAGE_EXTERNAL_STORAGE ให้สิทธิ์ต่อไปนี้

  • สิทธิ์การอ่านและการเขียนไฟล์ทั้งหมดภายในพื้นที่เก็บข้อมูลที่ใช้ร่วมกัน

  • สิทธิ์เข้าถึงเนื้อหาของตาราง MediaStore.Files

  • สิทธิ์เข้าถึงไดเรกทอรีรากของทั้งไดรฟ์ USB แบบใช้ระหว่างเดินทาง (OTG) และการ์ด SD

  • สิทธิ์การเขียนไดเรกทอรีพื้นที่เก็บข้อมูลภายในทั้งหมด ยกเว้น /Android/data/, /sdcard/Android และไดเรกทอรีย่อยส่วนใหญ่ของ /sdcard/Android สิทธิ์การเขียนนี้รวมถึงการเข้าถึงเส้นทางไฟล์โดยตรง

    แอปที่ได้รับสิทธิ์นี้จะยังคงเข้าถึงไดเรกทอรีเฉพาะแอปที่เป็นของแอปอื่นๆ ไม่ได้ เนื่องจากไดเรกทอรีเหล่านี้จะปรากฏเป็นไดเรกทอรีย่อยของ Android/data/ ในวอลุ่มพื้นที่เก็บข้อมูล

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

เรียกใช้กิจกรรมการจัดการพื้นที่เก็บข้อมูลของแอปอื่น

ใน Android 12 (API ระดับ 31) ขึ้นไป แอปที่มีทั้งสิทธิ์ MANAGE_EXTERNAL_STORAGE และสิทธิ์ QUERY_ALL_PACKAGES เช่น แอปการจัดการไฟล์ จะใช้ getManageSpaceActivityIntent() เพื่อส่งผู้ใช้ไปยังกิจกรรมการจัดการพื้นที่ที่กำหนดเองของแอปอื่นได้

เมธอด getManageSpaceActivityIntent() จะรับชื่อแพ็กเกจและรหัสคำขอ แล้วแสดงผลลัพธ์อย่างใดอย่างหนึ่งต่อไปนี้

  • PendingIntent หากแอปที่มีชื่อแพ็กเกจที่ระบุได้กําหนดกิจกรรม "จัดการพื้นที่เก็บข้อมูล" ที่กําหนดเอง จากนั้นแอปการจัดการไฟล์ที่เรียกใช้เมธอด getManageSpaceActivityIntent() จะเรียกใช้ Intent ที่แสดงผลเพื่อส่งผู้ใช้ไปยังกิจกรรมที่กําหนดเองได้
  • null หากแอปที่มีชื่อแพ็กเกจที่ระบุไม่ได้กำหนดกิจกรรม "จัดการพื้นที่ทำงาน"

เปิดใช้ MANAGE_EXTERNAL_STORAGE สำหรับการทดสอบ

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

adb shell appops set --uid PACKAGE_NAME MANAGE_EXTERNAL_STORAGE allow

ประกาศของ Google Play

ส่วนนี้จะแจ้งให้ทราบสำหรับนักพัฒนาแอปที่เผยแพร่แอปใน Google Play

Google Play Store ได้อัปเดตนโยบายเพื่อประเมินแอปที่กำหนดเป้าหมายเป็น Android 11 (API ระดับ 30) ขึ้นไปและขอสิทธิ์เข้าถึงไฟล์ทั้งหมดผ่านสิทธิ์ MANAGE_EXTERNAL_STORAGE เพื่อจำกัดการเข้าถึงแบบกว้างในพื้นที่เก็บข้อมูลที่ใช้ร่วมกัน นโยบายนี้มีผลตั้งแต่เดือนพฤษภาคม 2021

เมื่อแอปกำหนดเป้าหมายเป็น Android 11 ขึ้นไปและประกาศสิทธิ์ MANAGE_EXTERNAL_STORAGE แล้ว Android Studio จะแสดงคำเตือนเกี่ยวกับ Lint ที่ปรากฏในรูปที่ 1 คำเตือนนี้ช่วยเตือนคุณว่า Google Play Store มีนโยบายที่จำกัดการใช้สิทธิ์

รูปที่ 1 คำเตือน Lint ใน Android Studio ที่จะเตือนนักพัฒนาแอปเกี่ยวกับนโยบายของ Google Play เกี่ยวกับสิทธิ์ MANAGE_EXTERNAL_STORAGE

ขอสิทธิ์ MANAGE_EXTERNAL_STORAGE เฉพาะในกรณีที่แอปใช้ API ที่เป็นมิตรกับความเป็นส่วนตัวมากขึ้นอย่างมีประสิทธิภาพไม่ได้ เช่น เฟรมเวิร์กการเข้าถึงพื้นที่เก็บข้อมูลหรือ MediaStore API การใช้งานสิทธิ์ของแอปต้องอยู่ภายใต้การใช้งานที่อนุญาต และต้องเชื่อมโยงโดยตรงกับฟังก์ชันหลักของแอป หากแอปมี Use Case ที่คล้ายกับกรณีต่อไปนี้ ก็มีความเป็นไปได้ว่าแอปจะขอสิทธิ์ MANAGE_EXTERNAL_STORAGE ได้