Khả năng tương thích ngược còn lại

Thử cách Compose

Jetpack Compose là bộ công cụ giao diện người dùng được đề xuất cho Android. Tìm hiểu cách thêm chức năng tìm kiếm trong Compose.

Lọc danh sách →

SearchView và thanh thao tác chỉ có trên Android 3.0 trở lên. Để hỗ trợ các nền tảng cũ, bạn có thể quay lại hộp thoại tìm kiếm. Hộp thoại tìm kiếm là một giao diện người dùng do hệ thống cung cấp, sẽ phủ lên trên ứng dụng của bạn khi được gọi.

Đặt cấp độ API tối thiểu và mục tiêu

Để thiết lập hộp thoại tìm kiếm, trước tiên, hãy khai báo trong tệp kê khai rằng bạn muốn hỗ trợ các thiết bị cũ, nhưng muốn nhắm đến Android 3.0 trở lên. Khi bạn làm như vậy, ứng dụng của bạn sẽ tự động sử dụng thanh thao tác trên Android 3.0 trở lên và sử dụng hệ thống trình đơn truyền thống trên các thiết bị cũ hơn:

<uses-sdk android:minSdkVersion="7" android:targetSdkVersion="15" />

<application>
...

Cung cấp hộp thoại tìm kiếm cho các thiết bị cũ

Để gọi hộp thoại tìm kiếm trên các thiết bị cũ, hãy gọi onSearchRequested() bất cứ khi nào người dùng chọn mục trong trình đơn tìm kiếm trong trình đơn tùy chọn. Vì các thiết bị Android 3.0 trở lên hiển thị SearchView trong thanh thao tác (như minh hoạ trong bài học đầu tiên), nên chỉ những phiên bản cũ hơn 3.0 mới gọi onOptionsItemSelected() khi người dùng chọn mục tìm kiếm trong trình đơn.

Kotlin

override fun onOptionsItemSelected(item: MenuItem): Boolean {
    return when (item.itemId) {
        R.id.search -> {
            onSearchRequested()
            true
        }
        else -> false
    }
}

Java

@Override
public boolean onOptionsItemSelected(MenuItem item) {
    switch (item.getItemId()) {
        case R.id.search:
            onSearchRequested();
            return true;
        default:
            return false;
    }
}

Kiểm tra phiên bản bản dựng Android trong thời gian chạy

Trong thời gian chạy, hãy kiểm tra phiên bản thiết bị để đảm bảo không xảy ra trường hợp sử dụng SearchView không được hỗ trợ trên các thiết bị cũ. Trong mã ví dụ của chúng tôi, điều này xảy ra trong phương thức onCreateOptionsMenu():

Kotlin

override fun onCreateOptionsMenu(menu: Menu): Boolean {

    menuInflater.inflate(R.menu.options_menu, menu)

    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.HONEYCOMB) {
        val searchManager = getSystemService(Context.SEARCH_SERVICE) as SearchManager
        (menu.findItem(R.id.search).actionView as SearchView).apply {
            setSearchableInfo(searchManager.getSearchableInfo(componentName))
            setIconifiedByDefault(false)
        }
    }
    return true
}

Java

@Override
public boolean onCreateOptionsMenu(Menu menu) {

    MenuInflater inflater = getMenuInflater();
    inflater.inflate(R.menu.options_menu, menu);

    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.HONEYCOMB) {
        SearchManager searchManager =
                (SearchManager) getSystemService(Context.SEARCH_SERVICE);
        SearchView searchView =
                (SearchView) menu.findItem(R.id.search).getActionView();
        searchView.setSearchableInfo(
                searchManager.getSearchableInfo(getComponentName()));
        searchView.setIconifiedByDefault(false);
    }
    return true;
}