เชื่อมต่อกับเครือข่าย

หากต้องการดำเนินการด้านเครือข่ายในแอปพลิเคชัน ไฟล์ Manifest ต้องมีสิทธิ์ต่อไปนี้

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

หมายเหตุ: ทั้งสิทธิ์ INTERNET และ ACCESS_NETWORK_STATE เป็นสิทธิ์ปกติ ซึ่งหมายความว่าระบบจะให้สิทธิ์เหล่านี้เมื่อติดตั้งและไม่จำเป็นต้องขอสิทธิ์ขณะรันไทม์

แนวทางปฏิบัติแนะนำสำหรับการสื่อสารผ่านเครือข่ายที่ปลอดภัย

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

• ลดปริมาณข้อมูลผู้ใช้ที่มีความละเอียดอ่อนหรือข้อมูลส่วนบุคคลที่คุณส่งผ่านเครือข่าย
• ส่งการจราจรของข้อมูลในเครือข่ายทั้งหมดจากแอปของคุณผ่าน SSL
• ลองสร้างการกำหนดค่าการรักษาความปลอดภัยของเครือข่าย ซึ่งจะช่วยให้แอปเชื่อถือผู้ออกใบรับรอง (CA) ที่กำหนดเอง หรือจำกัดชุด CA ของระบบที่แอปเชื่อถือสำหรับการสื่อสารที่ปลอดภัย

ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีใช้หลักการสร้างเครือข่ายที่ปลอดภัยได้ที่เคล็ดลับการรักษาความปลอดภัยของเครือข่าย

เลือกไคลเอ็นต์ HTTP

แอปที่เชื่อมต่อเครือข่ายส่วนใหญ่ใช้ HTTP เพื่อส่งและรับข้อมูล แพลตฟอร์ม Android มีไคลเอ็นต์ HttpsURLConnection ซึ่งรองรับ TLS, การอัปโหลดและดาวน์โหลดสตรีมมิง, การหมดเวลาที่กำหนดค่าได้, IPv6 และพูลการเชื่อมต่อ

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

• Retrofit: ไคลเอ็นต์ HTTP ที่มีความปลอดภัยในการกำหนดประเภทสำหรับ JVM จาก Square ซึ่งสร้างขึ้นบน OkHttp Retrofit ช่วยให้คุณสร้างอินเทอร์เฟซไคลเอ็นต์แบบประกาศได้ และรองรับไลบรารีการแปลงเป็นอนุกรมหลายรายการ
• Ktor: ไคลเอ็นต์ HTTP จาก JetBrains ที่สร้างขึ้นสำหรับ Kotlin โดยเฉพาะและขับเคลื่อนโดยโครูทีน Ktor รองรับเครื่องมือ, ตัวแปลงอนุกรม และแพลตฟอร์มที่หลากหลาย

แก้ไขคำขอ DNS

อุปกรณ์ที่ใช้ Android 10 (ระดับ API 29) ขึ้นไปมีการรองรับในตัวสำหรับ DNS Lookup เฉพาะทางผ่านทั้งการค้นหาข้อความที่โอนหรือจัดเก็บได้โดยไม่ต้องเข้ารหัสและโหมด DNS-over-TLS DnsResolver API มีการแปลงชื่อแบบอะซิงโครนัสทั่วไป ซึ่งช่วยให้คุณค้นหา SRV, NAPTR และระเบียนประเภทอื่นๆ ได้ การแยกวิเคราะห์การตอบกลับจะปล่อยให้แอปเป็นผู้ดำเนินการ

ในอุปกรณ์ที่ใช้ Android 9 (ระดับ API 28) และต่ำกว่า รีโซลเวอร์ DNS ของแพลตฟอร์มจะรองรับเฉพาะระเบียน A และ AAAA ซึ่งจะช่วยให้คุณค้นหาที่อยู่ IP ที่เชื่อมโยงกับชื่อได้ แต่ไม่รองรับระเบียนประเภทอื่นๆ

สำหรับแอปที่ใช้ NDK โปรดดู android_res_nsend

รวมการดำเนินการของเครือข่ายไว้ในที่เก็บข้อมูล

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

คุณสามารถใช้ Retrofit เพื่อประกาศอินเทอร์เฟซที่ระบุเมธอด HTTP, URL, อาร์กิวเมนต์ และประเภทการตอบกลับสำหรับการดำเนินการของเครือข่ายได้ ดังตัวอย่างต่อไปนี้

Kotlin

interface UserService {
    @GET("/users/{id}")
    suspend fun getUser(@Path("id") id: String): User
}

Java

public interface UserService {
    @GET("/user/{id}")
    Call<User> getUserById(@Path("id") String id);
}

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

Kotlin

class UserRepository constructor(
    private val userService: UserService
) {
    suspend fun getUserById(id: String): User {
        return userService.getUser(id)
    }
}

Java

class UserRepository {
    private UserService userService;

    public UserRepository(
            UserService userService
    ) {
        this.userService = userService;
    }

    public Call<User> getUserById(String id) {
        return userService.getUser(id);
    }
}

อย่าดำเนินการกับเครือข่ายในชุดข้อความหลักเพื่อหลีกเลี่ยงการสร้าง UI ที่ไม่ตอบสนอง โดยค่าเริ่มต้น Android กำหนดให้คุณต้องดำเนินการด้านเครือข่ายในเธรดอื่นที่ไม่ใช่เธรด UI หลัก หากคุณพยายามดำเนินการเครือข่ายในเทรดหลัก ระบบจะแสดง NetworkOnMainThreadException

ในตัวอย่างโค้ดก่อนหน้า การดำเนินการของเครือข่ายไม่ได้ทริกเกอร์จริงๆ ผู้เรียก UserRepository ต้องใช้ชุดข้อความโดยใช้โครูทีนหรือใช้ฟังก์ชัน enqueue() ดูข้อมูลเพิ่มเติมได้ที่ Codelab รับข้อมูลจากอินเทอร์เน็ต ซึ่งสาธิตวิธีใช้การทำ Threading โดยใช้โครูทีนของ Kotlin

คงอยู่แม้จะมีการเปลี่ยนแปลงการกำหนดค่า

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

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

Kotlin

class MainViewModel constructor(
    savedStateHandle: SavedStateHandle,
    userRepository: UserRepository
) : ViewModel() {
    private val userId: String = savedStateHandle["uid"] ?:
        throw IllegalArgumentException("Missing user ID")

    private val _user = MutableLiveData<User>()
    val user = _user as LiveData<User>

    init {
        viewModelScope.launch {
            try {
                // Calling the repository is safe as it moves execution off
                // the main thread
                val user = userRepository.getUserById(userId)
                _user.value = user
            } catch (error: Exception) {
                // Show error message to user
            }

        }
    }
}

Java

class MainViewModel extends ViewModel {

    private final MutableLiveData<User> _user = new MutableLiveData<>();
    LiveData<User> user = (LiveData<User>) _user;

    public MainViewModel(
            SavedStateHandle savedStateHandle,
            UserRepository userRepository
    ) {
        String userId = savedStateHandle.get("uid");
        Call<User> userCall = userRepository.getUserById(userId);
        userCall.enqueue(new Callback<User>() {
            @Override
            public void onResponse(Call<User> call, Response<User> response) {
                if (response.isSuccessful()) {
                    _user.setValue(response.body());
                }
            }

            @Override
            public void onFailure(Call<User> call, Throwable t) {
                // Show error message to user
            }
        });
    }
}

อ่านคู่มือที่เกี่ยวข้อง

ดูข้อมูลเพิ่มเติมเกี่ยวกับหัวข้อนี้ได้ในคู่มือที่เกี่ยวข้องต่อไปนี้

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