Here's everything we announced at I/O, from new Firebase Studio features to more ways to integrate AI. Read blog.

Flutter 앱에서 Firebase 동적 링크 수신

생성한 Firebase 동적 링크를 수신하려면 앱에 동적 링크 SDK를 포함하고, 앱이 로드될 때 FirebaseDynamicLinks.getDynamicLink() 메서드를 호출하여 동적 링크로 전달된 데이터를 가져와야 합니다.

Firebase 및 동적 링크 SDK 설정

아직 수행하지 않았으면 Flutter에 Firebase SDK를 설치하고 초기화합니다.
Flutter 프로젝트의 루트 디렉터리에서 다음 명령어를 실행하여 동적 링크 플러그인을 설치합니다.
```
flutter pub add firebase_dynamic_links
```
Android 앱을 빌드하는 경우 Firebase Console의 프로젝트 설정 페이지를 열고 SHA-1 서명 키를 지정했는지 확인합니다. 앱 링크를 사용하는 경우에도 SHA-256 키를 지정합니다.

플랫폼 통합

앱을 빌드할 플랫폼에 대한 다음 플랫폼 통합 단계를 완료합니다.

Android

Android에서는 앱이 설치된 경우 동적 링크가 사용자 도메인으로 리디렉션되므로 도메인의 인텐트 필터 포착 딥 링크를 새로 추가해야 합니다. 이렇게 하려면 Play 스토어에서 앱을 설치 및 업데이트하고 계속 버튼을 탭한 후 앱에서 동적 링크 데이터를 수신해야 합니다. AndroidManifest.xml:

<intent-filter>
    <action android:name="android.intent.action.VIEW"/>
    <category android:name="android.intent.category.DEFAULT"/>
    <category android:name="android.intent.category.BROWSABLE"/>
    <data
        android:host="example.com"
        android:scheme="https"/>
</intent-filter>

사용자가 지정한 스키마 및 호스트로 연결되는 딥 링크가 포함된 동적 링크를 열면 앱에서 이 인텐트 필터로 링크를 처리하는 활동을 시작합니다.

다음 단계는 서명 인증서의 SHA-256 디지털 지문이 앱의 Firebase Console에 등록되었는지 확인하는 것입니다. SHA-256 디지털 지문을 가져오는 방법에 관한 자세한 내용은 클라이언트 인증 페이지에서 확인할 수 있습니다.

Apple 플랫폼

아직 없는 경우 Apple 개발자 계정을 생성합니다.
Firebase Console의 프로젝트 설정 페이지에서 iOS 앱이 App Store ID와 팀 ID로 올바르게 구성되어 있는지 확인합니다.
Apple 개발자 사이트에서 연결된 도메인 기능이 사용 설정된 앱의 프로비저닝 프로필을 만듭니다.
Xcode에서 다음을 수행합니다.
1. TARGETS 헤더에서 앱을 엽니다.
2. 서명 및 기능 페이지에서 팀이 등록되어 있고 프로비저닝 프로필이 설정되어 있는지 확인합니다.
3. 서명 및 기능 페이지에서 연결된 도메인을 사용 설정하고 연결된 도메인 목록에 다음을 추가합니다(예시를 내 도메인으로 바꾸기).
```
applinks:example.page.link
```
4. 정보 페이지에서 프로젝트에 URL 유형을 추가합니다. URL 스키마 필드를 앱의 번들 ID로 설정합니다. (식별자는 Bundle ID 또는 원하는 대로 지정할 수 있습니다.)
5. Firebase 프로젝트의 커스텀 도메인을 설정한 경우 FirebaseDynamicLinksCustomDomains 키를 사용하여 iOS 프로젝트의 Info.plist 파일에 동적 링크 URL 프리픽스를 추가합니다.
```
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>FirebaseDynamicLinksCustomDomains</key>
<array>
    <string>https://custom.domain.io/path1</string>
    <string>https://custom.domain.io/path2</string>
</array>

...other settings

</dict>
</plist>
```
6. 선택사항: 동적 링크 SDK의 iOS 페이스트보드 사용을 중지합니다.
  
  기본적으로 동적 링크 SDK는 페이스트보드를 사용하여 설치 후 딥 링크의 안정성을 개선합니다. 사용자가 동적 링크를 열었는데 앱을 먼저 설치해야 하는 경우에 페이스트보드를 사용하면 사용자가 설치 후 처음으로 앱을 열 때 원래 링크된 콘텐츠로 바로 이동할 수 있습니다.
  
  단점은 iOS 14 이상에서 페이스트보드를 사용하면 알림을 트리거한다는 것입니다. 따라서 사용자가 앱을 처음 열 때 페이스트보드에 동적 링크 URL이 포함되어 있으면 앱이 페이스트보드에 액세스했다는 알림이 표시되어 혼란을 일으킬 수 있습니다.
  
  이 동작을 사용 중지하려면 Xcode 프로젝트의 Info.plist 파일을 수정하고 FirebaseDeepLinkPasteboardRetrievalEnabled 키를 NO로 설정합니다.
  
  참고: 이 기능을 사용 중지하면 수신하는 동적 링크는 matchType으로 weak만 포함하게 됩니다. 앱의 로직을 적절하게 조정합니다.

딥 링크 처리

애플리케이션에서 동적 링크를 처리하려면 두 가지 시나리오를 구현해야 합니다.

종료 상태

다음 메서드를 설정합니다.

FirebaseDynamicLinks.getInitialLink - Future<PendingDynamicLinkData?>를 반환합니다.
FirebaseDynamicLinks.onLink - PendingDynamicLinkData?가 포함된 Stream을 반환하는 이벤트 핸들러입니다.

Android는 항상 종료된 상태에서 FirebaseDynamicLinks.getInitialLink를 통해 링크를 수신하지만 iOS에서는 보장되지 않습니다. 따라서 애플리케이션이 링크를 수신하도록 다음 순서로 모두 설정하는 것이 좋습니다.

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp(options: DefaultFirebaseConfig.platformOptions);

  // Check if you received the link via `getInitialLink` first
  final PendingDynamicLinkData? initialLink = await FirebaseDynamicLinks.instance.getInitialLink();

  if (initialLink != null) {
    final Uri deepLink = initialLink.link;
    // Example of using the dynamic link to push the user to a different screen
    Navigator.pushNamed(context, deepLink.path);
  }

  FirebaseDynamicLinks.instance.onLink.listen(
        (pendingDynamicLinkData) {
          // Set up the `onLink` event listener next as it may be received here
          if (pendingDynamicLinkData != null) {
            final Uri deepLink = pendingDynamicLinkData.link;
            // Example of using the dynamic link to push the user to a different screen
            Navigator.pushNamed(context, deepLink.path);
          }
        },
      );

  runApp(MyApp(initialLink));
}

그런 다음 애플리케이션 로직에서 링크가 처리되었는지 확인하고 작업을 수행할 수 있습니다. 예를 들면 다음과 같습니다.

if (initialLink != null) {
  final Uri deepLink = initialLink.link;
  // Example of using the dynamic link to push the user to a different screen
  Navigator.pushNamed(context, deepLink.path);
}

백그라운드 / 포그라운드 상태

애플리케이션이 열려 있는 동안 또는 백그라운드에서 FirebaseDynamicLinks.onLink getter를 사용합니다.

FirebaseDynamicLinks.instance.onLink.listen((dynamicLinkData) {
  Navigator.pushNamed(context, dynamicLinkData.link.path);
}).onError((error) {
  // Handle errors
});

또는 애플리케이션을 열 때 정확한 동적 링크가 사용되었는지 확인하려면 getDynamicLink 메서드에 다음을 대신 전달합니다.

String link = 'https://dynamic-link-domain/ke2Qa';

final PendingDynamicLinkData? initialLink = await FirebaseDynamicLinks.instance.getDynamicLink(Uri.parse(link));

iOS 플랫폼에서 동적 링크 테스트

iOS에서 동적 링크를 테스트하려면 실제 기기를 사용해야 합니다. 또한 종료된 앱 상태(즉, 스와이프하여 앱을 닫은 상태)에서 동적 링크를 테스트하는 경우 출시 모드 (즉, flutter run --release)에서도 앱을 실행해야 합니다.