algoliasearch client android
3.27.0
우리의 Android API 클라이언트는 레거시이며 유지 관리 모드에서만 가능합니다. Android 개발에 더 적합한 Kotlin API 클라이언트를 사용하는 것이 좋습니다.
Algolia Search는 첫 번째 키 입력부터 실시간 결과를 제공할 수 있는 호스팅 검색 엔진입니다.
Android용 Algolia Search API 클라이언트를 사용 하면 Android 코드에서 Algolia Search REST API를 쉽게 사용할 수 있습니다.
참고: Android 클라이언트 버전 2.x를 사용하고 있다면 버전 3.x로의 마이그레이션 가이드를 읽어보세요.
자동으로 생성된 참조 문서를 찾아볼 수 있습니다.
이 프로젝트는 MIT 라이선스에 따른 오픈 소스입니다.
귀하의 기여를 환영합니다! 코딩 스타일을 일관되게 유지하려면 서식 구성을 사용하세요.
Algolia 웹사이트에서 전체 참조 자료를 찾을 수 있습니다.
기여
설치하다
빠른 시작
푸시 데이터
구성
찾다
사용 가능한 방법 목록
도움 받기
사용 가능한 방법 목록
Gradle 빌드 파일에 다음 종속성을 추가하여 Android 클라이언트를 설치합니다.
dependencies {
// [...]
implementation ' com.algolia:algoliasearch-android:3.+ '
// This will automatically update to the latest v3 release when you build your project
}30초 안에 이 빠른 시작 튜토리얼에서는 개체를 색인화하고 검색하는 방법을 보여줍니다.
시작하려면 클라이언트를 초기화해야 합니다. 이를 위해서는 애플리케이션 ID 와 API 키가 필요합니다. Algolia 계정에서 둘 다 찾을 수 있습니다.
Client client = new Client ( "YourApplicationID" , "YourAPIKey" );
Index index = client . getIndex ( "your_index_name" );경고: 모바일에서 기본 앱을 구축하는 경우 검색 API 키를 소스 코드에 직접 포함하지 마세요 . 대신 앱이 시작되는 동안 서버에서 키를 가져오는 것을 고려해야 합니다.
사전 구성 없이 다음 코드를 사용하여 contacts 색인에서 연락처 색인화를 시작할 수 있습니다.
Index index = client . initIndex ( "contacts" );
index . addObjectAsync ( new JSONObject ()
. put ( "firstname" , "Jimmie" )
. put ( "lastname" , "Barninger" )
. put ( "followers" , 93 )
. put ( "company" , "California Paint" ), null );
index . addObjectAsync ( new JSONObject ()
. put ( "firstname" , "Warren" )
. put ( "lastname" , "Speach" )
. put ( "followers" , 42 )
. put ( "company" , "Norwalk Crmc" ), null );설정을 사용자 정의하여 검색 동작을 미세 조정할 수 있습니다. 예를 들어 팔로어 수를 기준으로 사용자 지정 순위를 추가하여 내장된 관련성을 더욱 향상할 수 있습니다.
JSONObject settings = new JSONObject (). append ( "customRanking" , "desc(followers)" );
index . setSettingsAsync ( settings , null );또한 중요도(가장 중요한 것부터)에 따라 색인화하려는 속성 목록을 구성할 수도 있습니다.
참고: Algolia는 입력할 때 결과를 제안하도록 설계되었습니다. 즉, 일반적으로 접두사를 기준으로 검색하게 됩니다. 이 경우 어떤 적중이 가장 좋은지 결정하려면 속성의 순서가 중요합니다.
JSONObject settings = new JSONObject ()
. put ( "searchableAttributes" , "lastname" )
. put ( "searchableAttributes" , "firstname" )
. put ( "searchableAttributes" , "company" );
index . setSettingsAsync ( settings , null ); 이제 firstname , lastname , company 등으로 연락처를 검색할 수 있습니다(오타 포함).
CompletionHandler completionHandler = new CompletionHandler () {
@ Override
public void requestCompleted ( JSONObject content , AlgoliaException error ) {
// [...]
}
};
// Search for a first name
index . searchAsync ( new Query ( "jimmie" ), completionHandler );
// Search for a first name with typo
index . searchAsync ( new Query ( "jimie" ), completionHandler );
// Search for a company
index . searchAsync ( new Query ( "california paint" ), completionHandler );
// Search for a first name and a company
index . searchAsync ( new Query ( "jimmie paint" ), completionHandler );
