Bắt đầu

Trang này mô tả cách thiết lập SDK Android. Nếu bạn chưa hoàn thành các điều kiện tiên quyết, hãy hoàn thành các điều kiện đó trước.

Phần phụ thuộc

Nhập SDK "searchinapps" vào một dự án Android từ GMaven. Mở tệp build.gradle của dự án, khai báo kho lưu trữ Google Maven và thêm phần phụ thuộc SDK:

repositories {
  google()
  ...
}

dependencies {
  implementation 'com.google.android.libraries.searchinapps:searchinapps:[version]'
  ...
}

Sau đó, hãy tạo dự án bằng Gradle.

Cấu hình AndroidManifest.xml

Cập nhật tệp AndroidManifest.xml của dự án Android để thêm siêu dữ liệu sau:

  1. com.google.searchinapps.API_KEY: giá trị chuỗi của khoá API SDK (xem ở trên).
  2. com.google.searchinapps.CLIENT_ID: giá trị chuỗi của mã nhận dạng ứng dụng khách của ứng dụng (xem ở trên).

Mẫu AndroidManifest.xml

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.google.samples.quickstart.searchinapps">

<application
...
>
<meta-data
android:name="com.google.searchinapps.API_KEY"
android:value="[your api key]"/>
<meta-data
android:name="com.google.searchinapps.CLIENT_ID"
android:value="[your client id]"/>
...
</application>

</manifest>

Khởi chạy

Để sử dụng các hàm của SDK "searchinapps", trong Activity mục tiêu hoặc bất kỳ lớp nào chịu trách nhiệm truy xuất kết quả tìm kiếm, hãy tạo một thực thể SearchInAppsService (bạn có thể thực hiện việc này trong hàm onCreate của lớp Hoạt động) và cũng truyền hoạt động hoặc Ngữ cảnh ứng dụng vào đó.

Mã mẫu

Java

package ...;

...
import androidx.appcompat.app.AppCompatActivity;
import com.google.android.libraries.searchinapps.SearchInAppsService;
...

public class MainActivity extends AppCompatActivity {
  private SearchInAppsService service;

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    ...
    service = SearchInAppsService.create(this);
    ...
  }

  @Override
  public void onDestroy() {
    service.shutDown();
    super.onDestroy();
  }
}

Jetpack Compose

package ...

...
import android.os.Bundle
import androidx.activity.compose.setContent
import androidx.appcompat.app.AppCompatActivity
import androidx.compose.runtime.Composable
import androidx.compose.runtime.DisposableEffect
import androidx.compose.runtime.mutableStateOf
import androidx.compose.ui.platform.LocalContext
import com.google.android.libraries.searchinapps.SearchInAppsService
...

class MainActivityJetpack : AppCompatActivity() {
  private var service: SearchInAppsService? = null

  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContent {
      SearchSuggestionsUI()
    }
  }

  @Composable
  fun SearchSuggestionsUI() {
    ...
    var service by remember {
      mutableStateOf<SearchInAppsService?>(
        SearchInAppsService.create(LocalContext.current))
    }
    ...
    DisposableEffect(Unit) { onDispose { service?.shutDown() } }
    ...
  }
  ...
}

Tiếp theo: Tính năng tìm kiếm