instantsearch ios 다운로드 - instantsearch ios 소스 코드 다운로드

instantsearch ios

기타 소스코드

7.26.3

다운로드

인스턴트서치 iOS

알골리아에서.

InstantSearch iOS는 Algolia를 사용하여 iOS에서 최고의 즉시 검색 환경을 구축하는 데 도움이 되는 구성 요소와 도우미를 제공하는 프레임워크입니다. Algolia의 Swift API 클라이언트 라이브러리를 기반으로 구축되어 다양한 검색 인터페이스를 신속하게 구축할 수 있는 높은 수준의 솔루션을 제공합니다.

구조

InstantSearch iOS는 세 가지 제품으로 구성됩니다.

InstantSearch Insights – 개발자가 검색 관련 이벤트를 캡처할 수 있는 라이브러리
InstantSearch Core – InstantSearch의 비즈니스 로직 모듈
InstantSearch – UIKit 구성요소를 포함한 완전한 InstantSearch 도구 세트
InstantSearch SwiftUI – 핵심 구성 요소 위에 사용할 SwiftUI 데이터 모델 및 뷰 세트

예

예제 프로젝트에서 InstantSearch iOS가 작동하는 모습을 볼 수 있습니다. 여기에는 InstantSearch로 구축되고 Swift로 작성된 검색 구성 요소와 경험이 포함되어 있습니다.

설치

스위프트 패키지 관리자

Swift Package Manager는 Swift 코드 배포를 관리하는 도구입니다. 이는 Swift 빌드 시스템과 통합되어 종속성 다운로드, 컴파일 및 연결 프로세스를 자동화합니다. Swift 5 및 Xcode 11 출시 이후 SPM은 앱 제작을 위한 iOS, macOS 및 tvOS 빌드 시스템과 호환됩니다.

SwiftPM을 사용하려면 Xcode 11을 사용하여 프로젝트를 열어야 합니다. File -> Swift Packages -> Add Package Dependency 클릭하고 InstantSearch 저장소의 URL을 입력하세요. 다음으로, 제공된 목록에서 프로젝트에 사용할 제품을 선택하세요.

프레임워크 작성자이고 InstantSearch를 종속성으로 사용하는 경우 Package.swift 파일을 업데이트하세요.

 let package = Package (
    // 7.26.0 ..< 8.0.0
    dependencies : [
        . package ( url : " https://github.com/algolia/instantsearch-ios " , from : " 7.26.0 " )
    ] ,
    // ...
)

코코아 포드

CocoaPods는 Cocoa 프로젝트의 종속성 관리자입니다.

InstantSearch를 설치하려면 Podfile에 다음 줄을 추가하기만 하면 됩니다.

 pod 'InstantSearch' , '~> 7.26'
# pod 'InstantSearch/Insights' for access to Insights library only
# pod 'InstantSearch/Core' for access business logic without UIKit components
# pod 'InstantSearch/SwiftUI' for access to SwiftUI components

그런 다음 다음 명령을 실행하십시오.

$ pod update

카르타고

Carthage는 Cocoa를 위한 간단하고 분산된 종속성 관리자입니다.

InstantSearch를 설치하려면 Cartfile에 다음 줄을 추가하기만 하면 됩니다.

 github "algolia/instantsearch-ios" ~> 7.26

프로젝트 디렉터리에서 다음 명령을 실행합니다.

carthage update
./Carthage/Checkouts/instant-search-ios/carthage-prebuild
carthage build

참고: 현재 Carthage는 특정 저장소 하위 구성 요소(또는 CocoaPods의 하위 사양과 동등한 구성 요소)만 빌드하는 방법을 제공하지 않습니다. 모든 구성 요소와 해당 종속성은 위 명령으로 빌드됩니다. 그러나 사용하지 않는 프레임워크를 프로젝트에 복사할 필요는 없습니다. 예를 들어 InstantSearch 의 UI 구성 요소를 사용하지 않는 경우 carthage update 완료된 후 InstantSearchCore 만 유지하면서 Carthage Build 디렉터리에서 해당 프레임워크를 삭제해도 됩니다. 이벤트 추적 기능만 필요한 경우 InstantSearchInsights 프레임워크를 제외하고 모두 삭제하세요.

프로젝트에서 Carthage를 처음 사용하는 경우 Carthage에서 설명한 대로 몇 가지 추가 단계를 거쳐야 합니다.

선적 서류 비치

시작 안내서로 시작할 수 있습니다.

전용 문서 웹사이트에서 instantSearch iOS에 대해 자세히 알아보세요.

기본 사용법

ViewController.swift 에서:

import InstantSearch

struct Item : Codable {
  let name : String
}

class SearchResultsViewController : UITableViewController , HitsController {
  
  var hitsSource : HitsInteractor < Item > ?
    
  override func viewDidLoad ( ) {
    super . viewDidLoad ( )
    tableView . register ( UITableViewCell . self , forCellReuseIdentifier : " cell " )
  }
      
  override func tableView ( _ tableView : UITableView , numberOfRowsInSection section : Int ) -> Int {
    hitsSource ? . numberOfHits ( ) ?? 0
  }
  
  override func tableView ( _ tableView : UITableView , cellForRowAt indexPath : IndexPath ) -> UITableViewCell {
    let cell = tableView . dequeueReusableCell ( withIdentifier : " cell " , for : indexPath )
    cell . textLabel ? . text = hitsSource ? . hit ( atIndex : indexPath . row ) ? . name
    return cell
  }
  
  override func tableView ( _ tableView : UITableView , didSelectRowAt indexPath : IndexPath ) {
    if let _ = hitsSource ? . hit ( atIndex : indexPath . row ) {
      // Handle hit selection
    }
  }
  
}

class ViewController : UIViewController {
      
  lazy var searchController = UISearchController ( searchResultsController : hitsViewController )
  let hitsViewController = SearchResultsViewController ( )

  let searcher = HitsSearcher ( appID : " latency " ,
                              apiKey : " 1f6fd3a6fb973cb08419fe7d288fa4db " ,
                              indexName : " bestbuy " )
  lazy var searchConnector = SearchConnector < Item > ( searcher : searcher ,
                                                    searchController : searchController ,
                                                    hitsInteractor : . init ( ) ,
                                                    hitsController : hitsViewController )
  
  override func viewDidLoad ( ) {
    super . viewDidLoad ( )
    searchConnector . connect ( )
    searcher . search ( )
    setupUI ( )
  }
  
  override func viewDidAppear ( _ animated : Bool ) {
    super . viewDidAppear ( animated )
    searchController . isActive = true
  }
  
  func setupUI ( ) {
    view . backgroundColor = . white
    navigationItem . searchController = searchController
    searchController . hidesNavigationBarDuringPresentation = false
    searchController . showsSearchResultsController = true
    searchController . automaticallyShowsCancelButton = false
  }
      
}

이제 애플리케이션을 빌드하고 실행하여 실제 기본 검색 환경을 확인할 수 있습니다. 각 키 입력마다 결과가 변경되는 것을 확인해야 합니다.

보다 의미 있는 검색 경험을 얻으려면 시작 안내서를 따르십시오. SwiftUI 애플리케이션을 구축하는 경우 SwiftUI 시작하기 가이드를 확인하세요.

프로젝트에 비즈니스 로직 모듈만 필요하고 InstantSearchCore 프레임워크를 사용하는 경우 소스 파일에 import InstantSearchCore 추가하세요.

로그

라이브러리에서 생성되는 로그 심각도에는 7가지 수준이 있습니다. 기본 심각도 수준은 .info 입니다. 다음과 같이 로깅 수준을 구성할 수 있습니다.

 Logs.logSeverityLevel = .debug

원격 측정

InstantSearch iOS는 런타임에 데이터 포인트를 수집합니다. 이는 InstantSearch 팀이 향후 개발을 개선하고 우선순위를 정하는 데 도움이 됩니다.

수집된 데이터의 전체 목록은 다음과 같습니다.

인스턴트서치 버전
인스턴스화된 InstantSearch 구성 요소의 이름(예: HitsSearcher , FilterState
사용자 정의 매개변수(재정의된 기본값)가 있는 구성요소의 이름입니다. InstantSearch는 해당 매개변수의 값을 수집하지 않습니다. 예를 들어 FacetListInteractor 의 facets 값의 기본값은 빈 목록입니다. 패싯 목록으로 인스턴스화하면 원격 분석은 facets 매개변수가 사용자 지정 값을 수신했지만 값 자체는 수신하지 않았음을 추적합니다.

InstantSearch는 민감한 데이터나 개인 데이터를 수집하지 않습니다. 그러나 다음 코드를 사용하여 원격 분석 수집을 옵트아웃할 수 있습니다.

 InstantSearchTelemetry . shared . isEnabled = false

도움 받기

도움이 필요하십니까 ? Algolia 커뮤니티나 Stack Overflow에 질문하세요.
문제가 발생했나요? 지원을 요청하기 전에 프레임워크와 관련된 가장 일반적인 문제와 문제점에 대한 답변을 찾을 수 있는 FAQ로 이동하는 것이 좋습니다.
버그를 발견하셨나요? GitHub 문제를 열 수 있습니다.
알골리아에 대해 궁금하세요? 당사 웹사이트에서 FAQ를 검색하실 수 있습니다.