การเริ่มต้นใช้งาน

หน้านี้อธิบายวิธีตั้งค่าใช้งาน Android SDK หากยังไม่ได้ทำตาม ข้อกำหนดเบื้องต้น โปรดทำตาม ข้อกำหนดเบื้องต้นก่อน

ทรัพยากร Dependency

นำเข้า SDK "searchinapps" ไปยังโปรเจ็กต์ Android จาก GMaven เปิดไฟล์ build.gradle ของโปรเจ็กต์ ประกาศ ที่เก็บ Maven ของ Google และเพิ่มทรัพยากร Dependency ของ SDK ดังนี้

repositories {
  google()
  ...
}

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

จากนั้นสร้างโปรเจ็กต์โดยใช้ Gradle

การกำหนดค่า AndroidManifest.xml

อัปเดตไฟล์ AndroidManifest.xml ของโปรเจ็กต์ Android เพื่อเพิ่มข้อมูลเมตาต่อไปนี้

1. com.google.searchinapps.API_KEY: ค่าสตริงของคีย์ API ของ SDK (ดูด้านบน)
2. com.google.searchinapps.CLIENT_ID: ค่าสตริงของตัวระบุไคลเอ็นต์ของแอป (ดูด้านบน)

ตัวอย่าง 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>

การเริ่มต้น

หากต้องการใช้ฟังก์ชันของ SDK "searchinapps" ให้สร้างอินสแตนซ์ SearchInAppsService ใน Activity เป้าหมายหรือคลาสใดก็ตามที่มีหน้าที่ดึงข้อมูลผลการค้นหา (คุณสามารถสร้างอินสแตนซ์ในฟังก์ชัน onCreate ของคลาส Activity ได้) และส่ง Context ของกิจกรรมหรือแอปพลิเคชันไปยังอินสแตนซ์ดังกล่าวด้วย

โค้ดตัวอย่าง

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() } }
    ...
  }
  ...
}

ถัดไป: ฟีเจอร์การค้นหา