กรณีการใช้งานพื้นที่เก็บข้อมูลของ Android และแนวทางปฏิบัติแนะนำ

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

แสดงรูปภาพหรือวิดีโอจากโฟลเดอร์ที่ต้องการ

ใช้แนวทางนี้

  1. ขอสิทธิ์ READ_EXTERNAL_STORAGE ตามแนวทางปฏิบัติแนะนำที่ระบุไว้ในขอสิทธิ์ของแอป
  2. ดึงข้อมูลไฟล์สื่อตามค่าของ MediaColumns.DATA ซึ่งมีเส้นทางระบบไฟล์สัมบูรณ์ไปยังรายการสื่อบนดิสก์

หมายเหตุ: เมื่อเข้าถึงไฟล์สื่อที่มีอยู่ คุณจะใช้ค่าของคอลัมน์ DATA ในตรรกะได้ นั่นเป็นเพราะค่านี้มีเส้นทางไฟล์ที่ถูกต้อง อย่างไรก็ตาม อย่าคิดว่าไฟล์จะพร้อมใช้งานเสมอไป เตรียมพร้อมรับมือกับข้อผิดพลาด I/O ที่อิงตามไฟล์ที่อาจเกิดขึ้น

ในทางกลับกัน หากต้องการสร้างหรืออัปเดตไฟล์สื่อ อย่าใช้คอลัมน์ DATA แต่ให้ใช้คอลัมน์ DISPLAY_NAME และ RELATIVE_PATH แทน

เข้าถึงข้อมูลตำแหน่งจากรูปภาพ

หากแอปใช้พื้นที่เก็บข้อมูลแบบจำกัด ให้ทำตามขั้นตอนในส่วนข้อมูลตำแหน่งในรูปภาพของคู่มือพื้นที่เก็บข้อมูลสื่อ

กำหนดตำแหน่งพื้นที่เก็บข้อมูลสำหรับการดาวน์โหลดใหม่

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

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

ใน Android 11 ขึ้นไป แอปอื่นๆ จะเข้าถึงไฟล์ที่อยู่ในไดเรกทอรีเฉพาะแอปภายนอกไม่ได้ แม้ว่าคุณจะใช้ DownloadManager เพื่อดึงข้อมูลไฟล์เหล่านี้ก็ตาม

ส่งออกไฟล์สื่อของผู้ใช้ไปยังอุปกรณ์

กำหนดตำแหน่งเริ่มต้นที่เหมาะสมเพื่อจัดเก็บไฟล์สื่อของผู้ใช้

แก้ไขหรือลบไฟล์สื่อหลายรายการในการดำเนินการเดียว

ใช้ตรรกะตามเวอร์ชัน Android ที่แอปของคุณทำงานอยู่

ใช้งานใน Android 11

ใช้แนวทางนี้

  1. สร้าง Intent ที่รอดําเนินการสําหรับคําขอเขียนหรือลบของแอปโดยใช้ MediaStore.createWriteRequest() หรือ MediaStore.createTrashRequest() จากนั้นแจ้งให้ผู้ใช้ขอสิทธิ์แก้ไขชุดไฟล์โดยการเรียกใช้ Intent นั้น

  2. ประเมินคำตอบของผู้ใช้

    • หากได้รับสิทธิ์แล้ว ให้ดําเนินการแก้ไขหรือลบ
    • หากผู้ใช้ไม่ให้สิทธิ์ โปรดอธิบายให้ผู้ใช้ทราบว่าเหตุใดฟีเจอร์ในแอปจึงต้องใช้สิทธิ์ดังกล่าว

ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีจัดการกลุ่มไฟล์สื่อโดยใช้วิธีการเหล่านี้ที่มีให้ใช้งานใน Android 11 ขึ้นไป

ใช้งานใน Android 10

หากแอปกำหนดเป้าหมายเป็น Android 10 (API ระดับ 29) ให้เลือกไม่ใช้พื้นที่เก็บข้อมูลแบบจำกัดและใช้แนวทางสำหรับ Android 9 และต่ำกว่าต่อไปเพื่อดำเนินการนี้

ใช้งานใน Android 9 หรือต่ำกว่า

ใช้แนวทางนี้

  1. ขอสิทธิ์ WRITE_EXTERNAL_STORAGE ตามแนวทางปฏิบัติแนะนำที่ระบุไว้ในขอสิทธิ์ของแอป
  2. ใช้ MediaStore API เพื่อแก้ไขหรือลบไฟล์สื่อ

นําเข้ารูปภาพเดียวที่มีอยู่แล้ว

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

นำเสนออินเทอร์เฟซผู้ใช้ของคุณเอง

ใช้แนวทางนี้

  1. ขอสิทธิ์ READ_EXTERNAL_STORAGE ตามแนวทางปฏิบัติแนะนำที่ระบุไว้ในขอสิทธิ์ของแอป
  2. ใช้ query() API เพื่อค้นหาคอลเล็กชันสื่อ
  3. แสดงผลลัพธ์ใน UI ที่กําหนดเองของแอป

ใช้เครื่องมือเลือกของระบบ

ใช้ Intent ACTION_GET_CONTENT ซึ่งจะขอให้ผู้ใช้เลือกรูปภาพที่จะนําเข้า

หากต้องการกรองประเภทรูปภาพที่เครื่องมือเลือกของระบบจะแสดงให้ผู้ใช้เลือก ให้ใช้ setType() หรือ EXTRA_MIME_TYPES

จับภาพรูปภาพเดียว

เมื่อต้องการจับภาพเพียงภาพเดียวเพื่อใช้ในแอป (เช่น เพื่อใช้เป็นรูปโปรไฟล์ของผู้ใช้) ให้ใช้ Intent ACTION_IMAGE_CAPTURE เพื่อขอให้ผู้ใช้ถ่ายรูปโดยใช้กล้องของอุปกรณ์ ระบบจะจัดเก็บรูปภาพที่ถ่ายไว้ในตาราง MediaStore.Images

แชร์ไฟล์สื่อกับแอปอื่นๆ

ใช้วิธี insert() เพื่อเพิ่มระเบียนลงใน MediaStore โดยตรง ดูข้อมูลเพิ่มเติมได้ที่ส่วนเพิ่มรายการของคู่มือพื้นที่เก็บข้อมูลสื่อ

แชร์ไฟล์สื่อกับแอปที่เฉพาะเจาะจง

ใช้คอมโพเนนต์ FileProvider ของ Android ตามที่อธิบายไว้ในคู่มือการตั้งค่าการแชร์ไฟล์

เข้าถึงไฟล์จากโค้ดหรือไลบรารีที่ใช้เส้นทางไฟล์โดยตรง

ใช้ตรรกะตามเวอร์ชัน Android ที่แอปของคุณทำงานอยู่

ใช้งานใน Android 11

ใช้แนวทางนี้

  1. ขอสิทธิ์ READ_EXTERNAL_STORAGE ตามแนวทางปฏิบัติแนะนำที่ระบุไว้ในขอสิทธิ์ของแอป
  2. เข้าถึงไฟล์โดยใช้เส้นทางไฟล์โดยตรง

ดูข้อมูลเพิ่มเติมได้ที่ส่วนเกี่ยวกับวิธีเปิดไฟล์สื่อโดยใช้เส้นทางไฟล์โดยตรง

ใช้งานใน Android 10

หากแอปกำหนดเป้าหมายเป็น Android 10 (API ระดับ 29) ให้เลือกไม่ใช้พื้นที่เก็บข้อมูลแบบจำกัดและใช้แนวทางสำหรับ Android 9 และต่ำกว่าต่อไปเพื่อดำเนินการนี้

ใช้งานใน Android 9 หรือต่ำกว่า

ใช้แนวทางนี้

  1. ขอสิทธิ์ WRITE_EXTERNAL_STORAGE ตามแนวทางปฏิบัติแนะนำที่ระบุไว้ในขอสิทธิ์ของแอป
  2. เข้าถึงไฟล์โดยใช้เส้นทางไฟล์โดยตรง

จัดการไฟล์ที่ไม่ใช่สื่อ

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

กรณีการใช้งาน สรุป
เปิดไฟล์เอกสาร ใช้แนวทางเดียวกันกับ 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

ใช้แนวทางนี้

  1. ใช้รูปแบบพื้นที่เก็บข้อมูลแบบจำกัด
  2. กำหนดเป้าหมายเป็น Android 10 (API ระดับ 29) หรือต่ำกว่า
  3. ประกาศสิทธิ์ WRITE_EXTERNAL_STORAGE
  4. ดำเนินการเข้าถึงประเภทใดประเภทหนึ่งต่อไปนี้
    • การเข้าถึงไฟล์โดยใช้ MediaStore API
    • การเข้าถึงเส้นทางไฟล์โดยตรงโดยใช้ API เช่น File หรือ fopen()

ใช้งานในเวอร์ชันเก่า

ใช้เฟรมเวิร์กการเข้าถึงพื้นที่เก็บข้อมูล ซึ่งช่วยให้ผู้ใช้เลือกตำแหน่งในวอลุ่มพื้นที่เก็บข้อมูลรองที่แอปของคุณเขียนไฟล์ได้

ย้ายข้อมูลไฟล์ที่มีอยู่จากตำแหน่งพื้นที่เก็บข้อมูลเดิม

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

รักษาสิทธิ์เข้าถึงตำแหน่งพื้นที่เก็บข้อมูลเดิมสำหรับการย้ายข้อมูล

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

หากแอปกำหนดเป้าหมายเป็น Android 11

  1. ตั้งค่า Flag preserveLegacyExternalStorage เป็น true เพื่อเก็บรูปแบบพื้นที่เก็บข้อมูลเดิมเพื่อให้แอปย้ายข้อมูลของผู้ใช้ได้เมื่อผู้ใช้อัปเกรดแอปเวอร์ชันใหม่ที่กำหนดเป้าหมายเป็น Android 11

  2. เลือกไม่ใช้พื้นที่เก็บข้อมูลแบบจำกัดต่อไปเพื่อให้แอปเข้าถึงไฟล์ในตำแหน่งพื้นที่เก็บข้อมูลเดิมในอุปกรณ์ Android 10 ได้ต่อไป

หากแอปกำหนดเป้าหมายเป็น Android 10

เลือกไม่ใช้พื้นที่เก็บข้อมูลแบบจำกัดเพื่อให้ดูแลรักษาลักษณะการทํางานของแอปใน Android เวอร์ชันต่างๆ ได้ง่ายขึ้น

ย้ายข้อมูลแอป

เมื่อแอปพร้อมที่จะย้ายข้อมูล ให้ใช้แนวทางต่อไปนี้

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

  3. ติดตั้งใช้งานโค้ดที่ใช้ File API เพื่อย้ายไฟล์จากตำแหน่งปัจจุบันใน /sdcard/ ไปยังตำแหน่งที่เข้าถึงได้โดยใช้พื้นที่เก็บข้อมูลที่มีขอบเขต ดังนี้

    1. ย้ายไฟล์แอปส่วนตัวไปยังไดเรกทอรีที่แสดงผลโดยเมธอด getExternalFilesDir()
    2. ย้ายไฟล์ที่ไม่ใช่สื่อที่แชร์ไปยังไดเรกทอรีย่อยสำหรับแอปโดยเฉพาะของไดเรกทอรี Downloads/
  4. นําไดเรกทอรีพื้นที่เก็บข้อมูลเดิมของแอปออกจากไดเรกทอรี /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 ได้ที่เอกสารต่อไปนี้

บล็อกโพสต์