Android 10 ได้เปิดตัวกระบวนทัศน์การจัดเก็บข้อมูลใหม่สำหรับแอปที่เรียกว่าที่เก็บข้อมูลที่จำกัดขอบเขต เพื่อให้ผู้ใช้ควบคุมไฟล์ของตนได้มากขึ้นและจำกัดการจัดระเบียบไฟล์ การเปลี่ยนแปลงพื้นที่เก็บข้อมูลที่จำกัดขอบเขต จะเปลี่ยนวิธีที่แอปจัดเก็บและเข้าถึงไฟล์ในพื้นที่เก็บข้อมูลภายนอกของอุปกรณ์ หากต้องการช่วยคุณ ย้ายข้อมูลแอปให้รองรับ Scoped Storage โปรดทำตามแนวทางปฏิบัติแนะนำสำหรับ Use Case เกี่ยวกับพื้นที่เก็บข้อมูลที่พบบ่อย ซึ่งระบุไว้ในคู่มือนี้ กรณีการใช้งานจะจัดระเบียบ เป็น 2 หมวดหมู่ ได้แก่ การจัดการไฟล์สื่อและการจัดการ ไฟล์ที่ไม่ใช่สื่อ
ในหลายกรณี แอปจะสร้างไฟล์ที่แอปอื่นๆ ไม่จำเป็นต้องเข้าถึง หรือ ไม่ควรเข้าถึง ระบบจะระบุตำแหน่งพื้นที่เก็บข้อมูลเฉพาะแอปเพื่อจัดการไฟล์ดังกล่าว
ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีจัดเก็บและเข้าถึงไฟล์ใน Android ได้ที่คำแนะนำการฝึกอบรม เรื่องพื้นที่เก็บข้อมูล
จัดการไฟล์สื่อ
ส่วนนี้จะอธิบายกรณีการใช้งานทั่วไปบางอย่างสำหรับการจัดการไฟล์สื่อ (ไฟล์วิดีโอ รูปภาพ และเสียง) และอธิบายแนวทางระดับสูงที่แอปของคุณใช้ได้ ตารางต่อไปนี้สรุป Use Case แต่ละรายการ และลิงก์ ไปยังแต่ละส่วนที่มีรายละเอียดเพิ่มเติม
การเล่าเรื่องผ่าน | สรุป |
---|---|
แสดงไฟล์รูปภาพหรือวิดีโอทั้งหมด | ใช้แนวทางเดียวกันสำหรับ Android ทุกเวอร์ชัน |
แสดงรูปภาพหรือวิดีโอจากโฟลเดอร์ที่เฉพาะเจาะจง | ใช้แนวทางเดียวกันสำหรับ Android ทุกเวอร์ชัน |
เข้าถึงข้อมูลตำแหน่งจาก รูปภาพ | ใช้วิธีใดวิธีหนึ่งหากแอปใช้พื้นที่เก็บข้อมูลที่กำหนดขอบเขต ใช้ แนวทางอื่นหากแอปเลือกไม่ใช้พื้นที่เก็บข้อมูลที่กำหนดขอบเขต |
กำหนดตำแหน่งพื้นที่เก็บข้อมูลสำหรับการดาวน์โหลดใหม่ | ใช้วิธีใดวิธีหนึ่งหากแอปใช้พื้นที่เก็บข้อมูลที่กำหนดขอบเขต ใช้ แนวทางอื่นหากแอปเลือกไม่ใช้พื้นที่เก็บข้อมูลที่กำหนดขอบเขต |
ส่งออกไฟล์สื่อของผู้ใช้ไปยังอุปกรณ์ | ใช้แนวทางเดียวกันสำหรับ Android ทุกเวอร์ชัน |
แก้ไขหรือลบไฟล์สื่อหลายรายการใน การดำเนินการเดียว | ใช้วิธีการเดียวสำหรับ Android 11 สำหรับ Android 10 ให้เลือกไม่ใช้ Scoped Storage และใช้วิธีการสำหรับ Android 9 และต่ำกว่าแทน |
นำเข้ารูปภาพเดียวที่มีอยู่แล้ว | ใช้แนวทางเดียวกันสำหรับ Android ทุกเวอร์ชัน |
จับภาพเดียว | ใช้แนวทางเดียวกันสำหรับ Android ทุกเวอร์ชัน |
แชร์ไฟล์สื่อกับแอปอื่นๆ | ใช้แนวทางเดียวกันสำหรับ Android ทุกเวอร์ชัน |
แชร์ไฟล์สื่อกับแอปที่เฉพาะเจาะจง | ใช้แนวทางเดียวกันสำหรับ Android ทุกเวอร์ชัน |
เข้าถึงไฟล์จากโค้ดหรือไลบรารี ที่ใช้เส้นทางไฟล์โดยตรง | ใช้วิธีการเดียวสำหรับ Android 11 สำหรับ Android 10 ให้เลือกไม่ใช้พื้นที่เก็บข้อมูลที่จำกัดขอบเขต และใช้วิธีการสำหรับ Android 9 และต่ำกว่าแทน |
แสดงไฟล์รูปภาพหรือวิดีโอจากหลายโฟลเดอร์
ค้นหาคอลเล็กชันสื่อ
โดยใช้ query()
API หากต้องการกรองหรือจัดเรียงไฟล์สื่อ ให้ปรับพารามิเตอร์ projection
, selection
,
selectionArgs
และ sortOrder
แสดงรูปภาพหรือวิดีโอจากโฟลเดอร์ที่เฉพาะเจาะจง
ใช้วิธีการต่อไปนี้
- ทำตามแนวทางปฏิบัติแนะนำที่ระบุไว้ในขอสิทธิ์ของแอป
ขอสิทธิ์
READ_EXTERNAL_STORAGE
- ดึงข้อมูลไฟล์สื่อตามค่าของ
MediaColumns.DATA
ซึ่งมีเส้นทางระบบไฟล์สัมบูรณ์ไปยังรายการสื่อในดิสก์
หมายเหตุ: เมื่อเข้าถึงไฟล์สื่อที่มีอยู่ คุณจะใช้ค่า
ของคอลัมน์ DATA
ในตรรกะได้ เนื่องจากค่านี้มีเส้นทางไฟล์ที่ถูกต้อง
อย่างไรก็ตาม อย่าคิดว่าไฟล์จะพร้อมใช้งานเสมอไป เตรียมพร้อมรับมือกับ
ข้อผิดพลาดของ I/O ที่อิงตามไฟล์ที่อาจเกิดขึ้น
ในทางกลับกัน หากต้องการสร้างหรืออัปเดตไฟล์สื่อ อย่าใช้คอลัมน์
DATA
แต่ให้ใช้คอลัมน์ DISPLAY_NAME
และ
RELATIVE_PATH
แทน
เข้าถึงข้อมูลตำแหน่งจากรูปภาพ
หากแอปใช้พื้นที่เก็บข้อมูลที่กำหนดขอบเขต ให้ทำตามขั้นตอนในส่วนข้อมูลตำแหน่ง ในภาพถ่าย ของคู่มือพื้นที่เก็บข้อมูลสื่อ
กำหนดตำแหน่งพื้นที่เก็บข้อมูลสำหรับการดาวน์โหลดใหม่
หากแอปใช้พื้นที่เก็บข้อมูลที่จำกัดขอบเขต โปรดคำนึงถึงตำแหน่งที่คุณเลือก จัดเก็บไฟล์สื่อที่ดาวน์โหลด
หากแอปอื่นๆ ต้องเข้าถึงไฟล์ ให้พิจารณาใช้คอลเล็กชันสื่อที่กำหนดไว้อย่างชัดเจนสำหรับการดาวน์โหลดหรือคอลเล็กชันเอกสาร
ใน Android 11 ขึ้นไป แอปอื่นๆ จะเข้าถึงไฟล์ในไดเรกทอรีเฉพาะของแอปภายนอกไม่ได้ แม้ว่าคุณจะใช้ DownloadManager
เพื่อ
ดึงข้อมูลไฟล์เหล่านี้ก็ตาม
ส่งออกไฟล์สื่อของผู้ใช้ไปยังอุปกรณ์
กำหนดตำแหน่งเริ่มต้นที่เหมาะสมเพื่อจัดเก็บไฟล์สื่อของผู้ใช้
- อนุญาตให้ผู้ใช้เลือกว่าจะให้แอปอื่นๆ อ่านไฟล์สื่อได้หรือไม่ โดยใช้พื้นที่เก็บข้อมูลเฉพาะแอปหรือพื้นที่เก็บข้อมูลที่แชร์
- อนุญาตให้ผู้ใช้ส่งออกไฟล์จากไดเรกทอรีเฉพาะแอปไปยังตำแหน่งที่เข้าถึงได้ทั่วไปมากขึ้น ใช้คอลเล็กชันรูปภาพ วิดีโอ และเสียงของ MediaStore เพื่อส่งออกไฟล์สื่อไปยังแกลเลอรีของอุปกรณ์
แก้ไขหรือลบไฟล์สื่อหลายไฟล์ในการดำเนินการครั้งเดียว
รวมตรรกะตามเวอร์ชัน Android ที่แอปของคุณทำงาน
ทำงานบน Android 11
ใช้วิธีการต่อไปนี้
- สร้าง PendingIntent สำหรับคำขอเขียนหรือลบของแอปโดยใช้
MediaStore.createWriteRequest()
หรือMediaStore.createTrashRequest()
จากนั้นแจ้งให้ผู้ใช้ขอสิทธิ์แก้ไขชุดไฟล์โดยเรียกใช้ Intent นั้น ประเมินคำตอบของผู้ใช้
- หากได้รับสิทธิ์ ให้ดำเนินการแก้ไขหรือลบ
- หากไม่ได้รับสิทธิ์ โปรดอธิบายให้ผู้ใช้ทราบว่าทำไมฟีเจอร์ใน แอปของคุณจึงต้องใช้สิทธิ์
ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีจัดการกลุ่มไฟล์ สื่อโดยใช้วิธีการเหล่านี้ซึ่งพร้อมใช้งานใน Android 11 ขึ้นไป
ทำงานใน Android 10
หากแอปกำหนดเป้าหมายเป็น Android 10 (API ระดับ 29) ให้เลือกไม่ใช้ Scoped Storage และใช้วิธีการสำหรับ Android 9 และต่ำกว่าต่อไปเพื่อดำเนินการนี้
ใช้ Android 9 หรือต่ำกว่า
ใช้วิธีการต่อไปนี้
- ทำตามแนวทางปฏิบัติแนะนำที่ระบุไว้ในขอสิทธิ์ของแอป
ขอสิทธิ์
WRITE_EXTERNAL_STORAGE
- ใช้
MediaStore
API เพื่อแก้ไข หรือลบไฟล์สื่อ
นำเข้ารูปภาพเดียวที่มีอยู่แล้ว
เมื่อต้องการนำเข้ารูปภาพเดียวที่มีอยู่แล้ว (เช่น เพื่อใช้ เป็นรูปภาพสำหรับโปรไฟล์ของผู้ใช้) แอปจะใช้ UI ของตัวเองสำหรับการดำเนินการ หรือใช้ตัวเลือกของระบบก็ได้
นำเสนออินเทอร์เฟซผู้ใช้ของคุณเอง
ใช้วิธีการต่อไปนี้
- ทำตามแนวทางปฏิบัติแนะนำที่ระบุไว้ในขอสิทธิ์ของแอป
ขอสิทธิ์
READ_EXTERNAL_STORAGE
- ใช้
query()
API เพื่อค้นหาคอลเล็กชันสื่อ - แสดงผลลัพธ์ใน UI ที่กำหนดเองของแอป
ใช้เครื่องมือเลือกของระบบ
ใช้ Intent ACTION_GET_CONTENT
ซึ่งจะขอให้ผู้ใช้เลือกรูปภาพที่จะนำเข้า
หากต้องการกรองประเภทรูปภาพที่เครื่องมือเลือกของระบบแสดงต่อผู้ใช้เพื่อให้เลือก คุณสามารถใช้
setType()
หรือ EXTRA_MIME_TYPES
ได้
จับภาพเดียว
เมื่อต้องการถ่ายภาพเดียวเพื่อใช้ในแอป (เช่น ใช้เป็นรูปภาพสำหรับโปรไฟล์ของผู้ใช้) ให้ใช้ Intent
ACTION_IMAGE_CAPTURE
เพื่อขอให้ผู้ใช้ถ่ายรูปโดยใช้กล้องของอุปกรณ์ ระบบจะ
จัดเก็บรูปภาพที่ถ่ายในตาราง
MediaStore.Images
แชร์ไฟล์สื่อกับแอปอื่น
ใช้วิธี
insert()
เพื่อเพิ่มระเบียนลงใน MediaStore โดยตรง ดูข้อมูลเพิ่มเติมได้ที่ส่วนเพิ่มรายการของ
คู่มือการจัดเก็บสื่อ
แชร์ไฟล์สื่อกับแอปที่ต้องการ
ใช้คอมโพเนนต์ FileProvider
ของ Android ตามที่อธิบายไว้ในคู่มือการตั้งค่าการแชร์ไฟล์
เข้าถึงไฟล์จากโค้ดหรือไลบรารีที่ใช้เส้นทางไฟล์โดยตรง
รวมตรรกะตามเวอร์ชัน Android ที่แอปของคุณทำงาน
ทำงานบน Android 11
ใช้วิธีการต่อไปนี้
- ทำตามแนวทางปฏิบัติแนะนำที่ระบุไว้ในขอสิทธิ์ของแอป
ขอสิทธิ์
READ_EXTERNAL_STORAGE
- เข้าถึงไฟล์โดยใช้เส้นทางไฟล์โดยตรง
ดูข้อมูลเพิ่มเติมได้ที่ส่วนเกี่ยวกับวิธีเปิดไฟล์สื่อโดยใช้เส้นทางไฟล์โดยตรง
ทำงานใน Android 10
หากแอปกำหนดเป้าหมายเป็น Android 10 (API ระดับ 29) ให้เลือกไม่ใช้ Scoped Storage และใช้วิธีการสำหรับ Android 9 และต่ำกว่าต่อไปเพื่อดำเนินการนี้
ใช้ Android 9 หรือต่ำกว่า
ใช้วิธีการต่อไปนี้
- ทำตามแนวทางปฏิบัติแนะนำที่ระบุไว้ในขอสิทธิ์ของแอป
ขอสิทธิ์
WRITE_EXTERNAL_STORAGE
- เข้าถึงไฟล์โดยใช้เส้นทางไฟล์โดยตรง
จัดการไฟล์ที่ไม่ใช่สื่อ
ส่วนนี้จะอธิบายกรณีการใช้งานทั่วไปบางส่วนสำหรับการจัดการไฟล์ที่ไม่ใช่สื่อ และอธิบายแนวทางระดับสูงที่แอปของคุณใช้ได้ ตารางต่อไปนี้ สรุปกรณีการใช้งานแต่ละกรณี และลิงก์ไปยังส่วนต่างๆ ที่ มีรายละเอียดเพิ่มเติม
การเล่าเรื่องผ่าน | สรุป |
---|---|
เปิดไฟล์เอกสาร | ใช้แนวทางเดียวกันสำหรับ Android ทุกเวอร์ชัน |
เขียนไปยังไฟล์ใน วอลุ่มพื้นที่เก็บข้อมูลสำรอง | ใช้วิธีการเดียวสำหรับ Android 11 ใช้วิธีอื่นสำหรับ Android เวอร์ชันก่อนหน้า |
ย้ายข้อมูลไฟล์ที่มีอยู่จากที่เก็บข้อมูลเดิม | ย้ายข้อมูลไฟล์ไปยังพื้นที่เก็บข้อมูลที่จำกัดขอบเขตเมื่อเป็นไปได้ เลือกไม่ใช้พื้นที่เก็บข้อมูลที่จำกัดขอบเขตสำหรับ Android 10 เมื่อจำเป็น |
แชร์เนื้อหากับแอปอื่นๆ | ใช้แนวทางเดียวกันสำหรับ Android ทุกเวอร์ชัน |
แคชไฟล์ที่ไม่ใช่สื่อ | ใช้แนวทางเดียวกันสำหรับ Android ทุกเวอร์ชัน |
ส่งออกไฟล์ที่ไม่ใช่สื่อไปยังอุปกรณ์ | ใช้วิธีใดวิธีหนึ่งหากแอปใช้พื้นที่เก็บข้อมูลที่กำหนดขอบเขต ใช้ แนวทางอื่นหากแอปเลือกไม่ใช้พื้นที่เก็บข้อมูลที่กำหนดขอบเขต |
เปิดไฟล์เอกสาร
ใช้เจตนา ACTION_OPEN_DOCUMENT
เพื่อขอให้ผู้ใช้เลือกไฟล์ที่จะเปิดโดยใช้เครื่องมือเลือกของระบบ หากต้องการกรองประเภทไฟล์ที่เครื่องมือเลือกของระบบจะแสดงให้ผู้ใช้เลือก คุณสามารถใช้ setType()
หรือ EXTRA_MIME_TYPES
ได้
เช่น คุณสามารถค้นหาไฟล์ PDF, ODT และ TXT ทั้งหมดได้โดยใช้โค้ดต่อไปนี้
Kotlin
startActivityForResult( Intent(Intent.ACTION_OPEN_DOCUMENT).apply { addCategory(Intent.CATEGORY_OPENABLE) type = "*/*" putExtra(Intent.EXTRA_MIME_TYPES, arrayOf( "application/pdf", // .pdf "application/vnd.oasis.opendocument.text", // .odt "text/plain" // .txt )) }, REQUEST_CODE )
Java
Intent intent = new Intent(Intent.ACTION_OPEN_DOCUMENT); intent.addCategory(Intent.CATEGORY_OPENABLE); intent.setType("*/*"); intent.putExtra(Intent.EXTRA_MIME_TYPES, new String[] { "application/pdf", // .pdf "application/vnd.oasis.opendocument.text", // .odt "text/plain" // .txt }); startActivityForResult(intent, REQUEST_CODE);
เขียนไปยังไฟล์ในวอลุ่มพื้นที่เก็บข้อมูลรอง
วอลุ่มที่เก็บข้อมูลรองรวมถึงการ์ด SD คุณเข้าถึงข้อมูลเกี่ยวกับ
วอลุ่มพื้นที่เก็บข้อมูลที่ระบุได้โดยใช้คลาส StorageVolume
รวมตรรกะตามเวอร์ชัน Android ที่แอปของคุณทำงาน
ทำงานบน Android 11
ใช้วิธีการต่อไปนี้
- ใช้โมเดลพื้นที่เก็บข้อมูลที่จำกัดขอบเขต
- กำหนดเป้าหมายเป็น Android 10 (API ระดับ 29) หรือต่ำกว่า
- ประกาศสิทธิ์
WRITE_EXTERNAL_STORAGE
- ดำเนินการเข้าถึงประเภทใดประเภทหนึ่งต่อไปนี้
- การเข้าถึงไฟล์โดยใช้
MediaStore
API - การเข้าถึงเส้นทางไฟล์โดยตรงโดยใช้ API เช่น
File
หรือfopen()
- การเข้าถึงไฟล์โดยใช้
การทำงานในเวอร์ชันเก่า
ใช้เฟรมเวิร์กการเข้าถึงพื้นที่เก็บข้อมูล ซึ่งช่วยให้ผู้ใช้ เลือกตำแหน่งในวอลุ่มพื้นที่เก็บข้อมูลรองที่แอปของคุณสามารถเขียนไฟล์ได้
ย้ายข้อมูลไฟล์ที่มีอยู่จากตำแหน่งที่จัดเก็บข้อมูลเดิม
ระบบจะถือว่าไดเรกทอรีเป็นตำแหน่งเก็บข้อมูลเดิมหากไม่ใช่ไดเรกทอรีเฉพาะแอปหรือไดเรกทอรีที่แชร์แบบสาธารณะ หากแอปของคุณสร้างหรือใช้ไฟล์ในตำแหน่งที่เก็บข้อมูลเดิม เราขอแนะนำให้คุณย้ายไฟล์ของแอปไปยังตำแหน่งที่เข้าถึงได้ด้วยที่เก็บข้อมูลที่จำกัดขอบเขต และทำการเปลี่ยนแปลงแอปที่จำเป็นเพื่อทำงานกับไฟล์ในที่เก็บข้อมูลที่จำกัดขอบเขต
รักษาสิทธิ์เข้าถึงตำแหน่งพื้นที่เก็บข้อมูลเดิมสำหรับการย้ายข้อมูล
แอปของคุณต้องคงสิทธิ์เข้าถึงตำแหน่งพื้นที่เก็บข้อมูลเดิมไว้เพื่อ ย้ายไฟล์แอปไปยังตำแหน่งที่เข้าถึงได้ด้วยพื้นที่เก็บข้อมูลที่จำกัดขอบเขต แนวทางที่คุณควรใช้จะขึ้นอยู่กับระดับ API เป้าหมายของแอป
หากแอปกำหนดเป้าหมายเป็น Android 11
ตั้งค่าแฟล็ก
preserveLegacyExternalStorage
เป็นtrue
เพื่อรักษารูปแบบ พื้นที่เก็บข้อมูลเดิมไว้ เพื่อให้แอปย้ายข้อมูลของผู้ใช้ได้เมื่ออัปเกรดเป็นแอปเวอร์ชันใหม่ที่กำหนดเป้าหมายเป็น Android 11เลือกไม่ใช้พื้นที่เก็บข้อมูลที่จำกัดขอบเขตต่อไป เพื่อให้แอปเข้าถึงไฟล์ในตำแหน่งพื้นที่เก็บข้อมูลเดิมในอุปกรณ์ Android 10 ได้ต่อไป
หากแอปกำหนดเป้าหมายเป็น Android 10
เลือกไม่ใช้พื้นที่เก็บข้อมูลที่จำกัดขอบเขตเพื่อให้ดูแลลักษณะการทำงานของแอปใน Android เวอร์ชันต่างๆ ได้ง่ายขึ้น
ย้ายข้อมูลแอป
เมื่อแอปพร้อมที่จะย้ายข้อมูลแล้ว ให้ใช้วิธีการต่อไปนี้
- กำหนดเป้าหมาย Android 10 หรือต่ำกว่า
- เลือกไม่ใช้ที่เก็บข้อมูลที่จำกัดขอบเขตเพื่อให้ แอปของคุณมีสิทธิ์เข้าถึงไฟล์ที่คุณต้องย้ายข้อมูล
-
ติดตั้งใช้งานโค้ดที่ใช้
File
API เพื่อย้ายไฟล์จากตำแหน่งปัจจุบันใน/sdcard/
ไปยังตำแหน่งที่เข้าถึงได้ด้วยพื้นที่เก็บข้อมูลที่จำกัดขอบเขต- ย้ายไฟล์แอปส่วนตัวไปยังไดเรกทอรีที่ส่งคืนโดยเมธอด
getExternalFilesDir()
- ย้ายไฟล์ที่ไม่ใช่สื่อที่แชร์ไปยังไดเรกทอรีย่อยเฉพาะแอปของ
ไดเรกทอรี
Downloads/
- ย้ายไฟล์แอปส่วนตัวไปยังไดเรกทอรีที่ส่งคืนโดยเมธอด
- นำไดเรกทอรีที่เก็บข้อมูลเดิมของแอปออกจากไดเรกทอรี
/sdcard/
หลังจากติดตั้งแอปเวอร์ชันใหม่แล้ว ผู้ใช้จะทำกระบวนการย้ายข้อมูลในอุปกรณ์ให้เสร็จสมบูรณ์ คุณสามารถตรวจสอบกระบวนการย้ายข้อมูลในฐานผู้ใช้ได้โดยสร้างเหตุการณ์การวิเคราะห์
หลังจากที่ผู้ใช้ย้ายข้อมูลแล้ว ให้เผยแพร่การอัปเดตอีกครั้งในแอปของคุณ โดย กำหนดเป้าหมายเป็น Android 11
แชร์เนื้อหากับแอปอื่นๆ
หากต้องการแชร์ไฟล์ของแอปกับแอปอื่นเพียงแอปเดียว ให้ใช้
FileProvider
สำหรับแอปทั้งหมดที่ต้องแชร์ไฟล์ระหว่างกัน เราขอแนะนำให้ใช้ Content
Provider สำหรับแต่ละแอป แล้ว
ซิงค์ข้อมูลเมื่อมีการเพิ่มแอปไปยังคอลเล็กชัน
แคชไฟล์ที่ไม่ใช่สื่อ
แนวทางที่คุณควรใช้จะขึ้นอยู่กับประเภทไฟล์ที่ต้องการแคช
- ไฟล์ขนาดเล็กหรือไฟล์ที่มีข้อมูลที่ละเอียดอ่อน: ใช้
Context#getCacheDir()
- ไฟล์ขนาดใหญ่หรือไฟล์ที่ไม่มีข้อมูลที่ละเอียดอ่อน: ใช้
Context#getExternalCacheDir()
ส่งออกไฟล์ที่ไม่ใช่สื่อไปยังอุปกรณ์
กำหนดตำแหน่งเริ่มต้นที่เหมาะสมเพื่อจัดเก็บไฟล์ที่ไม่ใช่สื่อ อนุญาตให้ผู้ใช้ส่งออกไฟล์จากไดเรกทอรีเฉพาะแอปไปยังตำแหน่งที่เข้าถึงได้ทั่วไปมากขึ้น ใช้การดาวน์โหลดหรือคอลเล็กชันเอกสารของ MediaStore เพื่อส่งออกไฟล์ที่ไม่ใช่สื่อไปยัง อุปกรณ์
จัดการไฟล์เฉพาะแอป
ในกรณีที่แอปสร้างไฟล์ที่แอปอื่นไม่จำเป็นต้องเข้าถึง หรือไม่ควรเข้าถึง คุณจะจัดเก็บไฟล์เหล่านี้ไว้ในตำแหน่งที่เก็บข้อมูลเฉพาะของแอปได้
ไดเรกทอรีที่เก็บข้อมูลภายใน
ระบบจะป้องกันไม่ให้แอปอื่นๆ เข้าถึงตำแหน่งเหล่านี้ และ ใน Android 10 (API ระดับ 29) ขึ้นไป ระบบจะเข้ารหัสตำแหน่งเหล่านี้ ตำแหน่งเหล่านี้ เป็นที่ที่เหมาะสำหรับการจัดเก็บข้อมูลที่ละเอียดอ่อนซึ่งมีเพียงแอปของคุณเท่านั้นที่เข้าถึงได้
ไดเรกทอรีพื้นที่เก็บข้อมูลภายนอก
หากที่จัดเก็บข้อมูลภายในมีพื้นที่ไม่เพียงพอที่จะจัดเก็บไฟล์เฉพาะของแอป ให้ลองใช้ที่จัดเก็บข้อมูลภายนอกแทน แม้ว่าแอปอื่นจะเข้าถึงไดเรกทอรีเหล่านี้ได้ หากแอปนั้นมีสิทธิ์ที่เหมาะสม แต่ไฟล์ที่จัดเก็บไว้ในไดเรกทอรีเหล่านี้ มีไว้สำหรับแอปของคุณเท่านั้น
ใน Android 4.4 (API ระดับ 19) ขึ้นไป แอปไม่จำเป็นต้องขอสิทธิ์ที่เกี่ยวข้องกับพื้นที่เก็บข้อมูลเพื่อเข้าถึงไดเรกทอรีเฉพาะของแอปภายในพื้นที่เก็บข้อมูลภายนอก
เมื่อผู้ใช้ถอนการติดตั้งแอป ไฟล์ที่บันทึกไว้ในที่เก็บข้อมูลเฉพาะของแอปจะถูกนำออก ดังนั้นคุณไม่ควรใช้ที่เก็บข้อมูลนี้เพื่อบันทึกสิ่งใดก็ตามที่ผู้ใช้คาดหวังว่าจะยังคงอยู่โดยไม่ขึ้นอยู่กับแอปของคุณ
เลือกไม่ใช้พื้นที่เก็บข้อมูลที่จำกัดขอบเขตชั่วคราว
ก่อนที่แอปจะเข้ากันได้กับพื้นที่เก็บข้อมูลที่จำกัดขอบเขตอย่างเต็มรูปแบบ คุณสามารถเลือกไม่ใช้ชั่วคราวได้ทั้งในการทดสอบและในแอปเวอร์ชันที่ใช้งานจริง
เลือกไม่ใช้ในการทดสอบ
ใน Android 10 (API ระดับ 29) ขึ้นไป การทดสอบของแอปจะทำงานในแซนด์บ็อกซ์พื้นที่เก็บข้อมูลโดยค่าเริ่มต้น แซนด์บ็อกซ์นี้จะป้องกันไม่ให้แอปเข้าถึงไฟล์ที่อยู่นอก ไดเรกทอรีเฉพาะแอปและไดเรกทอรีที่แชร์แบบสาธารณะ
หากการทดสอบสร้างไฟล์สำหรับโฮสต์ เช่น ภาพหน้าจอ ข้อมูลการแก้ไขข้อบกพร่อง
ข้อมูลความครอบคลุม หรือเมตริกประสิทธิภาพ คุณจะเขียนไฟล์เหล่านี้ลงในไดเรกทอรีส่วนกลางได้
โดยให้เพิ่มค่าสถานะต่อไปนี้ลงใน Harness ที่เกี่ยวข้องซึ่งเรียกใช้ am instrument
-e no-isolated-storage 1
แฟล็กนี้มีผลต่อลักษณะการทำงานทั้งหมดของกรณีทดสอบที่ใช้เครื่องมือ และมีผลต่อโค้ดทดสอบทั้งหมดที่เรียกใช้ ดังนั้น เมื่อใช้ Flag นี้ คุณจะตรวจสอบความเข้ากันได้ของแอปกับ Scoped Storage ไม่ได้ สำหรับเอาต์พุตการทดสอบ คุณควร
เขียนไปยังที่เก็บข้อมูลที่กำหนดขอบเขตแอปซึ่งเชลล์อ่านได้แทน จากนั้นคุณจะดึงข้อมูล
ไดเรกทอรีที่กำหนดขอบเขตแอปนั้นได้ หากต้องการกำหนดไดเรกทอรีที่จะดึงข้อมูล ให้เรียกใช้
getExternalMediaDirs()
เลือกไม่ใช้ในแอปเวอร์ชันที่ใช้งานจริง
หากแอปกำหนดเป้าหมายเป็น Android 10 (API ระดับ 29) หรือต่ำกว่า คุณสามารถเลือกไม่ใช้พื้นที่เก็บข้อมูลที่จำกัดขอบเขตในแอปเวอร์ชันที่ใช้งานจริงได้ชั่วคราว แต่หากกำหนดเป้าหมายเป็น Android 10 คุณจะต้องตั้งค่า requestLegacyExternalStorage
เป็น true
ในไฟล์ Manifest ของแอป
<manifest ... > <!-- This attribute is "false" by default on apps targeting Android 10. --> <application android:requestLegacyExternalStorage="true" ... > ... </application> </manifest>
หากต้องการทดสอบลักษณะการทำงานของแอปที่กำหนดเป้าหมายเป็น Android 10 หรือต่ำกว่าเมื่อใช้พื้นที่เก็บข้อมูลที่จำกัดขอบเขต คุณสามารถเลือกใช้ลักษณะการทำงานดังกล่าวได้โดยตั้งค่า requestLegacyExternalStorage
เป็น false
หากทดสอบในอุปกรณ์ที่
ใช้ Android 11 คุณยังใช้ฟีเจอร์
ความเข้ากันได้ของแอปเพื่อทดสอบลักษณะการทำงานของแอป
ที่มีหรือไม่มีพื้นที่เก็บข้อมูลที่จำกัดขอบเขตได้ด้วย
แหล่งข้อมูลเพิ่มเติม
ดูข้อมูลเพิ่มเติมเกี่ยวกับพื้นที่เก็บข้อมูล Android ได้จากสื่อต่อไปนี้