Android 10 ได้เปิดตัวรูปแบบพื้นที่เก็บข้อมูลใหม่สำหรับแอปที่เรียกว่าพื้นที่เก็บข้อมูลแบบจำกัด เพื่อให้ผู้ใช้ควบคุมไฟล์ได้มากขึ้นและจำกัดความกระจัดกระจายของไฟล์ พื้นที่เก็บข้อมูลแบบจำกัดจะเปลี่ยนวิธีที่แอปจัดเก็บและเข้าถึงไฟล์ในพื้นที่เก็บข้อมูลภายนอกของอุปกรณ์ โปรดทําตามแนวทางปฏิบัติแนะนําสําหรับ Use Case เกี่ยวกับพื้นที่เก็บข้อมูลที่พบบ่อยที่ระบุไว้ในคู่มือนี้เพื่อช่วยย้ายข้อมูลแอปให้รองรับพื้นที่เก็บข้อมูลแบบจำกัด กรณีการใช้งานจะจัดแบ่งออกเป็น 2 หมวดหมู่ ได้แก่ การจัดการไฟล์สื่อและการจัดการไฟล์ที่ไม่ใช่สื่อ
ในหลายกรณี แอปของคุณจะสร้างไฟล์ที่แอปอื่นๆ ไม่จำเป็นต้องเข้าถึงหรือไม่ควรเข้าถึง ระบบมีตำแหน่งพื้นที่เก็บข้อมูลเฉพาะแอปสำหรับจัดการไฟล์ดังกล่าว
ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีจัดเก็บและเข้าถึงไฟล์ใน Android ได้ที่คู่มือการฝึกอบรมเกี่ยวกับพื้นที่เก็บข้อมูล
จัดการไฟล์สื่อ
ส่วนนี้จะอธิบายกรณีการใช้งานทั่วไปบางกรณีสำหรับการจัดการไฟล์สื่อ (ไฟล์วิดีโอ รูปภาพ และเสียง) และอธิบายแนวทางระดับสูงที่แอปของคุณใช้ได้ ตารางต่อไปนี้สรุป Use Case แต่ละรายการเหล่านี้ และลิงก์ไปยังแต่ละส่วนที่มีรายละเอียดเพิ่มเติม
กรณีการใช้งาน | สรุป |
---|---|
แสดงไฟล์รูปภาพหรือวิดีโอทั้งหมด | ใช้แนวทางเดียวกันกับ Android ทุกเวอร์ชัน |
แสดงรูปภาพหรือวิดีโอจากโฟลเดอร์ที่เจาะจง | ใช้แนวทางเดียวกันกับ Android ทุกเวอร์ชัน |
เข้าถึงข้อมูลตำแหน่งจากรูปภาพ | ใช้แนวทางใดแนวทางหนึ่งหากแอปใช้พื้นที่เก็บข้อมูลที่กำหนดขอบเขต ใช้แนวทางอื่นหากแอปเลือกไม่ใช้พื้นที่เก็บข้อมูลที่กำหนดขอบเขต |
กำหนดตำแหน่งพื้นที่เก็บข้อมูลสำหรับการดาวน์โหลดใหม่ | ใช้แนวทางใดแนวทางหนึ่งหากแอปใช้พื้นที่เก็บข้อมูลที่กำหนดขอบเขต ใช้แนวทางอื่นหากแอปเลือกไม่ใช้พื้นที่เก็บข้อมูลที่กำหนดขอบเขต |
ส่งออกไฟล์สื่อของผู้ใช้ไปยังอุปกรณ์ | ใช้แนวทางเดียวกันกับ Android ทุกเวอร์ชัน |
แก้ไขหรือลบไฟล์สื่อหลายรายการในการดำเนินการเดียว | ใช้แนวทางเดียวสําหรับ Android 11 สำหรับ Android 10 ให้เลือกไม่ใช้พื้นที่เก็บข้อมูลแบบจำกัดขอบเขตและใช้แนวทางสำหรับ 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
ใช้แนวทางนี้
- สร้าง Intent ที่รอดําเนินการสําหรับคําขอเขียนหรือลบของแอปโดยใช้
MediaStore.createWriteRequest()
หรือMediaStore.createTrashRequest()
จากนั้นแจ้งให้ผู้ใช้ขอสิทธิ์แก้ไขชุดไฟล์โดยการเรียกใช้ Intent นั้น ประเมินการตอบกลับของผู้ใช้
- หากได้รับสิทธิ์แล้ว ให้ดําเนินการแก้ไขหรือลบ
- หากผู้ใช้ไม่ให้สิทธิ์ โปรดอธิบายให้ผู้ใช้ทราบว่าเหตุใดฟีเจอร์ในแอปจึงต้องใช้สิทธิ์ดังกล่าว
ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีจัดการกลุ่มไฟล์สื่อโดยใช้วิธีการเหล่านี้ที่มีให้ใช้งานใน Android 11 ขึ้นไป
ใช้งานใน Android 10
หากแอปกำหนดเป้าหมายเป็น Android 10 (API ระดับ 29) ให้เลือกไม่ใช้พื้นที่เก็บข้อมูลแบบจำกัดและใช้แนวทางสำหรับ Android 9 และต่ำกว่าต่อไปเพื่อดำเนินการนี้
ใช้งานใน Android 9 หรือต่ำกว่า
ใช้แนวทางนี้
- ขอสิทธิ์
WRITE_EXTERNAL_STORAGE
ตามแนวทางปฏิบัติแนะนำที่ระบุไว้ในขอสิทธิ์ของแอป - ใช้
MediaStore
API เพื่อแก้ไขหรือลบไฟล์สื่อ
นําเข้ารูปภาพเดียวที่มีอยู่แล้ว
เมื่อต้องการนําเข้ารูปภาพเดียวที่มีอยู่แล้ว (เช่น เพื่อใช้เป็นรูปโปรไฟล์ของผู้ใช้) แอปจะใช้ UI ของตนเองสําหรับการดำเนินการดังกล่าวหรือจะใช้เครื่องมือเลือกของระบบก็ได้
นำเสนออินเทอร์เฟซผู้ใช้ของคุณเอง
ใช้แนวทางนี้
- ขอสิทธิ์
READ_EXTERNAL_STORAGE
ตามแนวทางปฏิบัติแนะนำที่ระบุไว้ในขอสิทธิ์ของแอป - ใช้
query()
API เพื่อค้นหาคอลเล็กชันสื่อ - แสดงผลลัพธ์ใน UI ที่กําหนดเองของแอป
ใช้เครื่องมือเลือกของระบบ
ใช้ Intent ACTION_GET_CONTENT
ซึ่งจะขอให้ผู้ใช้เลือกรูปภาพที่จะนําเข้า
หากต้องการกรองประเภทรูปภาพที่เครื่องมือเลือกของระบบจะแสดงให้ผู้ใช้เลือก ให้ใช้ setType()
หรือ EXTRA_MIME_TYPES
จับภาพรูปภาพเดียว
เมื่อต้องการจับภาพ 1 รูปเพื่อใช้ในแอป (เช่น เพื่อใช้เป็นรูปโปรไฟล์ของผู้ใช้) ให้ใช้ Intent ACTION_IMAGE_CAPTURE
เพื่อขอให้ผู้ใช้ถ่ายรูปโดยใช้กล้องของอุปกรณ์ ระบบจะจัดเก็บรูปภาพที่ถ่ายไว้ในตาราง MediaStore.Images
แชร์ไฟล์สื่อกับแอปอื่นๆ
ใช้วิธี insert()
เพื่อเพิ่มระเบียนลงใน MediaStore โดยตรง ดูข้อมูลเพิ่มเติมได้ที่ส่วนเพิ่มรายการของคู่มือพื้นที่เก็บข้อมูลสื่อ
แชร์ไฟล์สื่อกับแอปที่เฉพาะเจาะจง
ใช้คอมโพเนนต์ FileProvider
ของ Android ตามที่อธิบายไว้ในคู่มือการตั้งค่าการแชร์ไฟล์
เข้าถึงไฟล์จากโค้ดหรือไลบรารีที่ใช้เส้นทางไฟล์โดยตรง
ใช้ตรรกะตามเวอร์ชัน Android ที่แอปของคุณทำงานอยู่
ใช้งานใน Android 11
ใช้แนวทางนี้
- ขอสิทธิ์
READ_EXTERNAL_STORAGE
ตามแนวทางปฏิบัติแนะนำที่ระบุไว้ในขอสิทธิ์ของแอป - เข้าถึงไฟล์โดยใช้เส้นทางไฟล์โดยตรง
ดูข้อมูลเพิ่มเติมได้ที่ส่วนเกี่ยวกับวิธีเปิดไฟล์สื่อโดยใช้เส้นทางไฟล์โดยตรง
ใช้งานใน Android 10
หากแอปกำหนดเป้าหมายเป็น Android 10 (API ระดับ 29) ให้เลือกไม่ใช้พื้นที่เก็บข้อมูลแบบจำกัดและใช้แนวทางสำหรับ Android 9 และต่ำกว่าต่อไปเพื่อดำเนินการนี้
ใช้งานใน Android 9 หรือต่ำกว่า
ใช้แนวทางนี้
- ขอสิทธิ์
WRITE_EXTERNAL_STORAGE
ตามแนวทางปฏิบัติแนะนำที่ระบุไว้ในขอสิทธิ์ของแอป - เข้าถึงไฟล์โดยใช้เส้นทางไฟล์โดยตรง
จัดการไฟล์ที่ไม่ใช่สื่อ
ส่วนนี้จะอธิบายกรณีการใช้งานทั่วไปบางกรณีสำหรับการจัดการไฟล์ที่ไม่ใช่สื่อ และอธิบายแนวทางระดับสูงที่แอปของคุณใช้ได้ ตารางต่อไปนี้สรุปกรณีการใช้งานแต่ละรายการเหล่านี้ รวมถึงลิงก์ไปยังแต่ละส่วนที่มีรายละเอียดเพิ่มเติม
กรณีการใช้งาน | สรุป |
---|---|
เปิดไฟล์เอกสาร | ใช้แนวทางเดียวกันกับ Android ทุกเวอร์ชัน |
เขียนลงในไฟล์ในวอลุ่มพื้นที่เก็บข้อมูลรอง | ใช้แนวทางเดียวสําหรับ Android 11 ใช้แนวทางอื่นสำหรับ Android เวอร์ชันเก่า |
ย้ายข้อมูลไฟล์ที่มีอยู่จากตำแหน่งการจัดเก็บเดิม | ย้ายข้อมูลไฟล์ไปยังพื้นที่เก็บข้อมูลแบบจำกัดเมื่อเป็นไปได้ เลือกไม่ใช้พื้นที่เก็บข้อมูลแบบจำกัดสำหรับ Android 10 เมื่อจำเป็น |
แชร์เนื้อหากับแอปอื่นๆ | ใช้แนวทางเดียวกันกับ Android ทุกเวอร์ชัน |
แคชไฟล์ที่ไม่ใช่สื่อ | ใช้แนวทางเดียวกันกับ Android ทุกเวอร์ชัน |
ส่งออกไฟล์ที่ไม่ใช่สื่อไปยังอุปกรณ์ | ใช้แนวทางใดแนวทางหนึ่งหากแอปใช้พื้นที่เก็บข้อมูลที่กำหนดขอบเขต ใช้แนวทางอื่นหากแอปเลือกไม่ใช้พื้นที่เก็บข้อมูลที่กำหนดขอบเขต |
เปิดไฟล์เอกสาร
ใช้ Intent 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
ตั้งค่า Flag
preserveLegacyExternalStorage
เป็นtrue
เพื่อเก็บรูปแบบพื้นที่เก็บข้อมูลเดิมเพื่อให้แอปย้ายข้อมูลของผู้ใช้ได้เมื่อผู้ใช้อัปเกรดแอปเวอร์ชันใหม่ที่กำหนดเป้าหมายเป็น Android 11เลือกไม่ใช้พื้นที่เก็บข้อมูลแบบจำกัดต่อไปเพื่อให้แอปเข้าถึงไฟล์ในตำแหน่งพื้นที่เก็บข้อมูลเดิมในอุปกรณ์ Android 10 ได้ต่อไป
หากแอปกำหนดเป้าหมายเป็น Android 10
เลือกไม่ใช้พื้นที่เก็บข้อมูลแบบจำกัดเพื่อให้ดูแลรักษาลักษณะการทํางานของแอปใน Android เวอร์ชันต่างๆ ได้ง่ายขึ้น
ย้ายข้อมูลแอป
เมื่อแอปพร้อมที่จะย้ายข้อมูล ให้ใช้แนวทางต่อไปนี้
- กำหนดเป้าหมายเป็น Android 10 หรือต่ำกว่า
- เลือกไม่ใช้พื้นที่เก็บข้อมูลแบบจำกัดเพื่อให้แอปของคุณมีสิทธิ์เข้าถึงไฟล์ที่คุณต้องย้ายข้อมูล
-
ติดตั้งใช้งานโค้ดที่ใช้
File
API เพื่อย้ายไฟล์จากตำแหน่งปัจจุบันใน/sdcard/
ไปยังตำแหน่งที่เข้าถึงได้โดยใช้พื้นที่เก็บข้อมูลที่มีขอบเขต ดังนี้- ย้ายไฟล์แอปส่วนตัวไปยังไดเรกทอรีที่แสดงผลโดยเมธอด
getExternalFilesDir()
- ย้ายไฟล์ที่ไม่ใช่สื่อที่แชร์ไปยังไดเรกทอรีย่อยสำหรับแอปโดยเฉพาะของไดเรกทอรี
Downloads/
- ย้ายไฟล์แอปส่วนตัวไปยังไดเรกทอรีที่แสดงผลโดยเมธอด
- นำไดเรกทอรีพื้นที่เก็บข้อมูลเดิมของแอปออกจากไดเรกทอรี
/sdcard/
หลังจากติดตั้งแอปเวอร์ชันใหม่แล้ว ผู้ใช้จะดำเนินการย้ายข้อมูลในอุปกรณ์ให้เสร็จสมบูรณ์ คุณสามารถตรวจสอบกระบวนการย้ายข้อมูลในฐานผู้ใช้ได้โดยสร้างเหตุการณ์การวิเคราะห์
หลังจากผู้ใช้ย้ายข้อมูลแล้ว ให้เผยแพร่การอัปเดตแอปอีกครั้งโดยกำหนดเป้าหมายเป็น Android 11
แชร์เนื้อหากับแอปอื่นๆ
หากต้องการแชร์ไฟล์ของแอปกับแอปอื่นแอปเดียว ให้ใช้ FileProvider
สำหรับแอปทั้งหมดที่ต้องแชร์ไฟล์ระหว่างกัน เราขอแนะนำให้ใช้ผู้ให้บริการเนื้อหาสำหรับแต่ละแอป แล้วซิงค์ข้อมูลเมื่อเพิ่มแอปลงในคอลเล็กชัน
แคชไฟล์ที่ไม่ใช่สื่อ
แนวทางที่คุณควรใช้จะขึ้นอยู่กับประเภทไฟล์ที่คุณต้องการแคช
- ไฟล์ขนาดเล็กหรือไฟล์ที่มีข้อมูลที่ละเอียดอ่อน: ใช้
Context#getCacheDir()
- ไฟล์ขนาดใหญ่หรือไฟล์ที่ไม่มีข้อมูลที่ละเอียดอ่อน: ใช้
Context#getExternalCacheDir()
ส่งออกไฟล์ที่ไม่ใช่สื่อไปยังอุปกรณ์
กำหนดตำแหน่งเริ่มต้นที่เหมาะสมเพื่อจัดเก็บไฟล์ที่ไม่ใช่สื่อ อนุญาตให้ผู้ใช้ส่งออกไฟล์จากไดเรกทอรีเฉพาะแอปไปยังตำแหน่งที่เข้าถึงได้ทั่วไปมากขึ้น ใช้รายการที่ดาวน์โหลดหรือคอลเล็กชันเอกสารของ MediaStore เพื่อส่งออกไฟล์ที่ไม่ใช่สื่อไปยังอุปกรณ์
จัดการไฟล์เฉพาะแอป
ในกรณีที่แอปสร้างไฟล์ที่แอปอื่นๆ ไม่จำเป็นต้องเข้าถึงหรือไม่ควรเข้าถึง คุณสามารถจัดเก็บไฟล์เหล่านี้ในตำแหน่งการจัดเก็บเฉพาะแอป
ไดเรกทอรีที่จัดเก็บข้อมูลภายใน
ระบบจะป้องกันไม่ให้แอปอื่นๆ เข้าถึงตำแหน่งเหล่านี้ และตำแหน่งเหล่านี้จะได้รับการเข้ารหัสใน Android 10 (API ระดับ 29) ขึ้นไป ตำแหน่งเหล่านี้เป็นสถานที่ที่ดีในการเก็บข้อมูลที่ละเอียดอ่อนซึ่งมีเพียงแอปของคุณเท่านั้นที่เข้าถึงได้
ไดเรกทอรีพื้นที่เก็บข้อมูลภายนอก
หากพื้นที่เก็บข้อมูลภายในมีพื้นที่ไม่เพียงพอที่จะจัดเก็บไฟล์เฉพาะแอป ให้พิจารณาใช้พื้นที่เก็บข้อมูลภายนอกแทน แม้ว่าแอปอื่นจะเข้าถึงไดเรกทอรีเหล่านี้ได้หากมีสิทธิ์ที่เหมาะสม แต่ไฟล์ที่จัดเก็บในไดเรกทอรีเหล่านี้มีไว้สำหรับแอปของคุณเท่านั้น
ใน Android 4.4 (API ระดับ 19) ขึ้นไป แอปของคุณไม่จําเป็นต้องขอสิทธิ์ใดๆ ที่เกี่ยวข้องกับพื้นที่เก็บข้อมูลเพื่อเข้าถึงไดเรกทอรีเฉพาะแอปภายในพื้นที่เก็บข้อมูลภายนอก
เมื่อผู้ใช้ถอนการติดตั้งแอป ระบบจะนำไฟล์ที่บันทึกไว้ในพื้นที่เก็บข้อมูลเฉพาะแอปออก ดังนั้นคุณไม่ควรใช้พื้นที่เก็บข้อมูลนี้เพื่อบันทึกข้อมูลใดๆ ที่ผู้ใช้คาดหวังว่าจะคงอยู่โดยไม่ขึ้นอยู่กับแอปของคุณ
เลือกไม่ใช้พื้นที่เก็บข้อมูลแบบจำกัดชั่วคราว
ก่อนที่แอปจะใช้งานพื้นที่เก็บข้อมูลแบบจำกัดได้อย่างเต็มรูปแบบ คุณสามารถเลือกใช้พื้นที่เก็บข้อมูลแบบจำกัดชั่วคราวได้ทั้งในการทดสอบและในแอปเวอร์ชันที่ใช้งานจริง
เลือกไม่ใช้ในการทดสอบ
ใน Android 10 (API ระดับ 29) ขึ้นไป การทดสอบของแอปจะทำงานใน sandbox พื้นที่เก็บข้อมูลโดยค่าเริ่มต้น แซนด์บ็อกซ์นี้ป้องกันไม่ให้แอปเข้าถึงไฟล์ที่อยู่นอกไดเรกทอรีเฉพาะแอปและไดเรกทอรีที่แชร์แบบสาธารณะ
หากการทดสอบแสดงผลไฟล์สําหรับโฮสต์ เช่น ภาพหน้าจอ ข้อมูลการแก้ไขข้อบกพร่อง ข้อมูลความครอบคลุม หรือเมตริกประสิทธิภาพ คุณสามารถเขียนไฟล์เหล่านี้ไปยังไดเรกทอรีส่วนกลางได้ โดยเพิ่ม Flag ต่อไปนี้ลงใน Harness ที่เกี่ยวข้องซึ่งเรียกใช้ am instrument
-e no-isolated-storage 1
Flag นี้มีผลต่อลักษณะการทำงานทั้งหมดของเคสทดสอบที่มีเครื่องมือวัด และมีผลต่อโค้ดทดสอบที่เรียกใช้ทั้งหมด ดังนั้น เมื่อใช้ Flag นี้ คุณจะไม่สามารถตรวจสอบความเข้ากันได้ของแอปกับพื้นที่เก็บข้อมูลแบบจำกัด สําหรับเอาต์พุตการทดสอบ คุณควรเขียนลงในพื้นที่เก็บข้อมูลระดับแอปที่เชลล์อ่านได้ จากนั้นคุณจะดึงไดเรกทอรีระดับแอปนั้นได้ หากต้องการระบุไดเรกทอรีที่จะดึงข้อมูล ให้เรียกใช้ 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 คุณยังใช้ Flag เกี่ยวกับความเข้ากันได้ของแอปเพื่อทดสอบลักษณะการทํางานของแอปที่มีหรือไม่มีพื้นที่เก็บข้อมูลแบบจำกัดได้ด้วย
แหล่งข้อมูลเพิ่มเติม
ดูข้อมูลเพิ่มเติมเกี่ยวกับพื้นที่เก็บข้อมูล Android ได้ที่เนื้อหาต่อไปนี้