생성된 iOS SDK 사용

Firebase Data Connect 클라이언트 SDK를 사용하면 Firebase 앱에서 바로 서버 측 쿼리 및 변형을 호출할 수 있습니다. 맞춤 클라이언트 SDK는 서비스에 배포하는 스키마, 쿼리, 변형을 설계할 때 Data Connect 동시에 생성합니다. 그런 다음 이 SDK의 메서드를 클라이언트 로직에 통합합니다.

다른 곳에서 언급했듯이 Data Connect 쿼리 및 변형은 클라이언트 코드에서 제출되지 않고 서버에서 실행된다는 점에 유의해야 합니다. 대신 배포되면 Data Connect 작업이 Cloud Functions와 같이 서버에 저장됩니다. 즉, 기존 사용자 (예: 이전 앱 버전)가 중단되지 않도록 상응하는 클라이언트 측 변경사항을 배포해야 합니다.

따라서 Data Connect는 서버 배포 스키마, 쿼리, 변형을 프로토타입으로 만들 수 있는 개발자 환경과 도구를 제공합니다. 또한 프로토타입을 만드는 동안 클라이언트 측 SDK를 자동으로 생성합니다.

서비스 및 클라이언트 앱에 대한 업데이트를 반복하면 서버 측 및 클라이언트 측 업데이트를 모두 배포할 수 있습니다.

Swift SDK 생성

Firebase CLI를 사용하여 앱에서 Data Connect 생성 SDK를 설정합니다. init 명령어는 현재 폴더의 모든 앱을 감지하고 생성된 SDK를 자동으로 설치합니다.

firebase init dataconnect:sdk

프로토타입을 만드는 동안 SDK 업데이트

Data Connect VS Code 확장 프로그램을 설치한 경우 생성된 SDK가 항상 최신 상태로 유지됩니다.

Data Connect VS Code 확장 프로그램을 사용하지 않는 경우 Firebase CLI를 사용하여 생성된 SDK를 최신 상태로 유지할 수 있습니다.

firebase dataconnect:sdk:generate --watch

빌드 파이프라인에서 SDK 생성

Firebase CLI를 사용하여 CI/CD 빌드 프로세스에서 Data Connect SDK를 생성할 수 있습니다.

firebase dataconnect:sdk:generate

Data Connect iOS SDK 초기화

Data Connect를 설정하는 데 사용한 정보 (Firebase Console Data Connect 탭에서 모두 사용 가능)를 사용하여 Data Connect 인스턴스를 초기화합니다.

커넥터 인스턴스 가져오기

커넥터 코드는 Data Connect 에뮬레이터에서 생성됩니다. connector.yaml에 지정된 대로 커넥터 이름이 movies이고 패키지가 movies인 경우 다음을 호출하여 커넥터 객체를 가져옵니다.

let connector = DataConnect.moviesConnector

쿼리 및 변형 구현

커넥터 객체를 사용하면 GraphQL 소스 코드에 정의된 대로 쿼리 및 변형을 실행할 수 있습니다. 커넥터에 다음과 같은 작업이 정의되어 있다고 가정해 보겠습니다.

mutation createMovie($title: String!, $releaseYear: Int!, $genre: String!, $rating: Int!) {
  movie_insert(data: {
    title: $title
    releaseYear: $releaseYear
    genre: $genre
    rating: $rating
  })
}

query getMovieByKey($key: Movie_Key!) {
  movie(key: $key) { id title }
}

query listMoviesByGenre($genre: String!) {
  movies(where: {genre: {eq: $genre}}) {
    id
    title
  }
}

그런 다음 다음과 같이 영화를 만들 수 있습니다.

let mutationResult = try await connector.createMovieMutation.execute(
  title: "Empire Strikes Back",
  releaseYear: 1980,
  genre: "Sci-Fi",
  rating: 5)

print("Movie ID: \(mutationResult.data.movie_insert.id)")

영화를 가져오려면 쿼리 참조를 사용합니다. 모든 쿼리 참조는 Observable 게시자입니다. 구성된 게시자 (connector.yaml) 참고)에 따라 매크로 (iOS 17 이상)를 지원하거나 ObservableObject 프로토콜을 구현합니다.@Observable 지정하지 않으면 기본값은 iOS 17 이상에서 지원되는 @Observable 매크로입니다.

SwiftUI 뷰에서 쿼리 참조의 게시된 data 변수를 사용하여 쿼리 결과를 바인딩하고 쿼리의 execute() 메서드를 호출하여 데이터를 업데이트할 수 있습니다. data 변수는 GQL 쿼리 정의에 정의된 데이터의 모양과 일치합니다.

가져온 모든 결과는 Decodable 프로토콜을 준수합니다. GQL 가져오기에 객체의 기본 키를 포함한 경우 객체도 Identifiable이므로 반복기에서 사용할 수 있습니다.

참고: @StateObject는 실시간으로 업데이트되지 않습니다. 게시자로 @Observable 매크로를 사용하는 경우에도 필요하지 않습니다.

struct ListMovieView: View {
    @StateObject private var queryRef = connector.listMoviesByGenreQuery.ref(genre: "Sci-Fi")
    var body: some View {
        VStack {
            Button {
                Task {
                    do {
                        try await refresh()
                    } catch {
                        print("Failed to refresh: \(error)")
                    }
                }
            } label: {
                Text("Refresh")
            }
                // use the query results in a view
            ForEach(queryRef.data?.movies ?? [], id: \.self.id) { movie in
                    Text(movie.title)
                }
            }
    }
    @MainActor
    func refresh() async throws {
        _ = try await queryRef.execute()
    }
}

쿼리는 일회성 실행도 지원합니다.

let resultData = try await DataConnect.moviesConnector.listMoviesByGenreQuery.execute(genre: "Sci-Fi")

열거 필드의 변경사항 처리

앱의 스키마에는 GraphQL 쿼리로 액세스할 수 있는 열거가 포함될 수 있습니다.

앱의 디자인이 변경되면 지원되는 새 enum 값을 추가할 수 있습니다. 예를 들어 애플리케이션의 수명 주기 후반에 AspectRatio enum에 FULLSCREEN 값을 추가한다고 가정해 보겠습니다.

Data Connect 워크플로에서는 로컬 개발 도구를 사용하여 쿼리 및 SDK를 업데이트할 수 있습니다.

하지만 업데이트된 버전의 클라이언트를 출시하기 전에 이전 배포된 클라이언트가 중단될 수 있습니다.

복원력 있는 구현 예

생성된 enum에 _UNKNOWN 값이 포함되어 있고 Swift에서 포괄적인 switch 문을 적용하므로 생성된 SDK는 알 수 없는 값의 처리를 강제합니다.

do {
    let result = try await DataConnect.moviesConnector.listMovies.execute()
    if let data = result.data {
        for movie in data.movies {
            switch movie.aspectratio {
                case .ACADEMY: print("academy")
                case .WIDESCREEN: print("widescreen")
                case .ANAMORPHIC: print("anamorphic")
                case ._UNKNOWN(let unknownAspect): print(unknownAspect)
            }
        }
    }
} catch {
    // handle error
}

iOS 애플리케이션 프로토타입 및 테스트

로컬 에뮬레이터를 사용하도록 클라이언트 계측

Data Connect VS Code 확장 프로그램 또는 CLI에서 Data Connect 에뮬레이터를 사용할 수 있습니다.

에뮬레이터에 연결하도록 앱을 계측하는 것은 두 시나리오 모두 동일합니다.

let connector = DataConnect.moviesConnector
// Connect to the emulator on "127.0.0.1:9399"
connector.useEmulator()

// (alternatively) if you're running your emulator on non-default port:
connector.useEmulator(port: 9999)

// Make calls from your app

Data Connect SDK의 데이터 유형

Data Connect 서버는 일반적인 GraphQL 데이터 유형과 커스텀 GraphQL 데이터 유형을 나타냅니다. 이러한 데이터 유형은 SDK에서 다음과 같이 표시됩니다.

Data Connect 유형	Swift
문자열	문자열
정수	정수
부동 소수점 수	Double
불리언	Bool
UUID	UUID
날짜	FirebaseDataConnect.LocalDate
타임스탬프	FirebaseCore.Timestamp
Int64	Int64
모두	FirebaseDataConnect.AnyValue