الخطوات الأولى

توضّح هذه الصفحة كيفية الإعداد باستخدام حزمة تطوير البرامج (SDK) لنظام التشغيل Android. إذا لم تكن قد اكتملت المتطلّبات الأساسية، عليك إكمالها أولاً.

اعتمادية

استورِد حزمة تطوير البرامج (SDK) "searchinapps" إلى مشروع Android من GMaven. افتحملفbuild.gradleproject، وأدخِل مستودع Google Maven وأضِف تبعية حزمة SDK:

repositories {
  google()
  ...
}

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

بعد ذلك، يمكنك إنشاء مشروعك باستخدام Gradle.

إعدادات ملف AndroidManifest.xml

عدِّل ملف AndroidManifest.xml لمشروع Android لإضافة يليه البيانات الوصفية:

1. ‫com.google.searchinapps.API_KEY: قيمة السلسلة لمفتاح واجهة برمجة التطبيقات لحزمة 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 لفئة النشاط) ويجب أيضًا تمرير سياق النشاط أو التطبيق إليه.

نموذج التعليمات البرمجية

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

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.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() {
    ...
    if (service == null) {
      service = SearchInAppsService.create(LocalContext.current)
    }
    ...
  }
  ...
}

الخطوة التالية: ميزات البحث