생성된 Flutter SDK 사용

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

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

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

서비스 및 클라이언트 앱에 대한 업데이트를 반복하면 서버 측 업데이트와 클라이언트 측 업데이트가 모두 배포될 준비가 됩니다.

클라이언트 개발 워크플로란 무엇인가요?

시작하기를 따른 경우 전반적인 개발 흐름이 소개되었습니다SQL Connect. 이 가이드에서는 스키마에서 Flutter SDK를 생성하고 클라이언트 쿼리 및 변형을 사용하는 방법에 관한 자세한 정보를 확인할 수 있습니다.

요약하자면 클라이언트 앱에서 생성된 Flutter SDK를 사용하려면 다음 필수 단계를 따르세요.

1. Flutter 앱에 Firebase를 추가합니다.
2. flutterfire CLI dart pub global activate flutterfire_cli를 설치합니다.
3. flutterfire configure를 실행합니다.

그런 다음 아래를 실행합니다.

1. 앱 스키마를 개발합니다.

2. SDK 생성을 설정합니다.

   • SQL Connect VS Code 확장 프로그램의 앱에 SDK 추가 버튼을 사용합니다.
   • connector.yaml을 업데이트합니다.

3. 클라이언트 코드를 초기화하고 라이브러리를 가져옵니다.

4. 쿼리 및 변형에 대한 호출을 구현합니다.

5. SQL Connect 에뮬레이터를 설정하고 사용하며 반복합니다.SQL Connect

Flutter SDK 생성

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

firebase init dataconnect:sdk

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

SQL Connect VS Code 확장 프로그램이 설치되어 있으면 생성된 SDK가 항상 최신 상태로 유지됩니다.

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

firebase dataconnect:sdk:generate --watch

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

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

firebase dataconnect:sdk:generate

클라이언트 코드 설정

SQL Connect 앱 초기화

먼저 표준 Firebase 설정 안내에 따라 앱을 초기화합니다.

그런 다음 SQL Connect 플러그인을 설치합니다.

flutter pub add firebase_data_connect

SQL Connect Flutter SDK 초기화

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

라이브러리 가져오기

클라이언트 코드를 초기화하는 데 필요한 가져오기에는 일반 SQL Connect 가져오기와 생성된 특정 SDK 가져오기의 두 가지 세트가 있습니다.

// general imports
import 'package:firebase_data_connect/firebase_data_connect.dart';

// generated queries and mutations from SDK
import 'generated/movies.dart';

클라이언트 측에서 쿼리 사용

생성된 코드에는 미리 정의된 쿼리 참조가 이미 포함되어 있습니다. 가져와서 execute를 호출하기만 하면 됩니다.

import 'generated/movies.dart';

await MoviesConnector.instance.listMovies().execute();

SDK 쿼리 메서드 호출

다음은 이러한 작업 바로가기 함수를 사용하는 예입니다.

import 'generated/movies.dart';

function onBtnClick() {
  // This will call the generated Dart from the CLI and then make an HTTP request to the server.
  MoviesConnector.instance.listMovies().execute().then(data => showInUI(data)); // == MoviesConnector.instance.listMovies().ref().execute();
}

선택사항 입력란

일부 쿼리에는 선택사항 입력란이 있을 수 있습니다. 이러한 경우 Flutter SDK는 빌더 메서드를 노출하며 별도로 설정해야 합니다.

예를 들어 createMovie를 호출할 때 rating 필드는 선택사항이므로 빌더 함수에서 제공해야 합니다.

await MoviesConnector.instance.createMovie({ title: 'Empire Strikes Back', releaseYear: 1980, genre: "Sci-Fi"}).rating(5).execute();

변경사항 구독

에서 실시간 업데이트 가져오기를 참고하세요.SQL Connect

열거 필드의 변경사항 처리

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

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

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

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

복원력 있는 구현 예

생성된 SDK는 알 수 없는 값의 처리를 강제합니다. 즉, 클라이언트 코드는 EnumValue 객체를 Known 또는 Unknown으로 언래핑해야 합니다.

final result = await MoviesConnector.instance.listMovies().execute();

if (result.data != null && result.data!.isNotEmpty) {
  handleEnumValue(result.data![0].aspectratio);
}

void handleEnumValue(EnumValue<AspectRatio> aspectValue) {
  if (aspectValue.value != null) {
    switch(aspectValue.value!) {
      case AspectRatio.ACADEMY:
        print("This movie is in Academy aspect");
        break;
      case AspectRatio.WIDESCREEN:
        print("This movie is in Widescreen aspect");
        break;
      case AspectRatio.ANAMORPHIC:
        print("This movie is in Anamorphic aspect");
        break;
      case AspectRatio.IMAX:
        print("This movie is in IMAX aspect");
    }
  } else {
    print("Unknown aspect ratio detected: ${aspectValue.stringValue}");
  }
}

클라이언트 측 캐싱 사용 설정

SQL Connect에는 connector.yaml 파일을 수정하여 사용 설정할 수 있는 선택적 클라이언트 측 캐싱 기능이 있습니다. 이 기능을 사용 설정하면 생성된 클라이언트 SDK가 쿼리 응답을 로컬로 캐시하므로 앱에서 실행하는 데이터베이스 요청 수를 줄이고 네트워크 연결이 중단될 때 앱의 데이터베이스 종속 부분이 작동하도록 할 수 있습니다.

클라이언트 측 캐싱을 사용 설정하려면 커넥터 구성에 클라이언트 캐싱 구성을 추가합니다.

generate:
  javascriptSdk:
    outputDir: ../dart/
    package: "dataconnect_generated"
    clientCache:
      maxAge: 5s
      storage: memory

이 구성에는 두 개의 매개변수가 있으며 둘 다 선택사항입니다.

• maxAge: 클라이언트 SDK가 새 값을 가져오기 전에 캐시된 응답이 있을 수 있는 최대 기간입니다. 예: '0', '30s', '1h30m'

  maxAge의 기본값은 0입니다. 즉, 응답이 캐시되지만 클라이언트 SDK는 항상 새 값을 가져옵니다. 캐시된 값은 CACHE_ONLY가 execute() 및 subscribe()에서 반환된 초기 결과에 지정된 경우에만 사용됩니다.

• storage: 클라이언트 SDK는 응답을 persistent 스토리지 또는 memory에 캐시하도록 구성할 수 있습니다. persistent 스토리지에 캐시된 결과는 앱을 다시 시작해도 유지됩니다. Android 또는 iOS를 타겟팅할 때 기본값은 persistent입니다. 웹브라우저를 타겟팅할 때는 memory 스토리지만 지원됩니다.

커넥터의 캐싱 구성을 업데이트한 후 클라이언트 SDK를 다시 생성하고 앱을 다시 빌드합니다. 이렇게 하면 execute() 및 subscribe()가 응답을 캐시하고 구성한 정책에 따라 캐시된 값을 사용합니다. 일반적으로 사용자가 추가 단계를 수행하지 않아도 자동으로 실행되지만 다음 사항에 유의하세요.

• execute()의 기본 동작은 위에 설명된 대로입니다. 쿼리에 결과가 캐시되고 캐시된 값이 maxAge보다 오래되지 않은 경우 캐시된 값을 사용합니다. 이 기본 동작을 PREFER_CACHE 정책이라고 합니다.

  캐시된 값만 제공 (CACHE_ONLY)하거나 서버에서 새 값을 무조건 가져오도록 (SERVER_ONLY) execute()의 개별 호출에 지정할 수도 있습니다.

  await queryRef.execute(fetchPolicy: QueryFetchPolicy.cacheOnly);
  

  await queryRef.execute(fetchPolicy: QueryFetchPolicy.serverOnly);
  

• subscribe()를 호출하면 maxAge 설정과 관계없이 캐시된 콘텐츠가 있는 경우 항상 즉시 반환됩니다. 후속 execute() 호출은 구성된 maxAge에 따라 리스너에게 알립니다.

클라이언트 측에서 변형 사용

변형은 쿼리와 동일한 방식으로 액세스할 수 있습니다.

await MoviesConnector.instance.createMovie({ title: 'Empire Strikes Back', releaseYear: 1980, genre: "Sci-Fi" }).rating(5).execute();

Flutter 앱 프로토타입 및 테스트

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

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

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

import 'package:firebase_data_connect/firebase_data_connect.dart';
import 'generated/movies.dart';

MoviesConnector.instance.dataConnect
          .useDataConnectEmulator('127.0.0.1', 9399);

// Make calls from your app
QueryRef<ListMoviesData, void> ref = MoviesConnector.instance.listMovies.ref();

프로덕션 리소스로 전환하려면 에뮬레이터에 연결하는 줄을 주석 처리합니다.

Dart SDK의 데이터 유형

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