명명된 매개변수 "required"

• 명명된 매개변수는 특히 매개변수가 많은 함수나 위젯에서 더 많은 유연성을 제공한다 중괄호 {} 안에 정의된 명명된 매개변수는 required 키워드로 표시되지 않는 한 기본적으로 선택적 !
• 함수를 호출할 때 명명된 매개변수는 매개변수 이름을 사용하여 지정되므로, 코드 가독성이 향상된다

선택적 매개변수 초기화

CompleteButton({
    super.key,
    required this.context,
    required this.onPressed,
    String? text,
    bool? disabled,
  })  
  // 초기화 리스트 이용한 선택적 매개변수 초기값 설정
  : text = text ?? '확인',
        disabled = disabled ?? false;

컬렉션(Collection)

• 일종의 데이터 모음(폴더)

문서(Document)

• 컬렉션 안에 들어 있는 단일 데이터 항목
• 각각의 문서는 고유한 ID(uid) 존재
• Map 형태의 데이터를 저장

스냅샷(Snapshot)

• 데이터베이스에서 특정 문서(Document)나 쿼리(Query)의 특정 시점의 데이터의 상태를 "사진처럼 찍어서" 저장한 객체
• 현재 상태 캡처 : 데이터베이스의 특정 시점에 존재하는 데이터를 그대로 가져온다
• 데이터 읽기 : 문서나 쿼리의 결과를 읽을 때 사용
• 실시간 추적 : dart-.snapshots() 메서드를 사용하면 데이터의 변화를 실시간으로 추적 가능

• QuerySnapshot<Map<String, dynamic>> QuerySnapshot - 여러 문서 검색 (collection.where(...).get()) → snapshot.docs.map((doc){}) 로 문서 반복

• DocumentSnapshot<Map<String, dynamic>> DocumentSnapshot - 특정 문서 1개 조회 (doc(id).get())

FirebaseFirestore.instance.batch() 여러 개의 쓰기 작업(write operations)을 하나의 트랜잭션처럼 묶어서 실행할 수 있도록 해주는 함수.

• 즉, 한 번에 여러 문서에 대해 set, update, delete 작업을 수행하고, 모두 성공하거나, 하나라도 실패하면 전부 실패를 보장하는 역할
• 이렇게 묶은 작업은 마지막에 batch.commit()을 호출해서 실행한다
• 예시

  // Firestore 식물 목록 저장
  Future<void> savePlantList(List<PlantModel> plants) async {
  final batch = FirebaseFirestore.instance.batch();
    for (final plant in plants) {
        final docRef = _collection.doc(plant.cntntsNo);
        batch.set(docRef, plant.toJson(), SetOptions(merge:     true)); // 병합 저장
      }
  await batch.commit();
  }

🔥 Firestore에서 DocumentReference 와 DocumentSnapshot 차이 완벽 정리

핵심 차이 요약

🔗 DocumentReference

• Firestore 문서를 가리키는 참조 객체
• 예: 문서를 생성하거나, 업데이트, 삭제할 때 사용
• 예제 코드

  final docRef = FirebaseFirestore.instance
    .collection('plants')
    .doc('myPlantId');
  await docRef.set({'name': '로즈마리'}); // 문서 생성 또는 덮어쓰기
  await docRef.update({'name': '바질'}); // 필드만 수정
  await docRef.delete(); // 문서 삭제

N-gram

• N-gram은 통계학 기반의 언어 모델 중 하나로, 텍스트나 연설에서 N개의 연속적인 항목(문자, 음절, 단어 등)의 시퀀스를 말합니다. 'N'은 숫자를 나타내며, 문자열을 일정한 길이 N으로 끊어서 중복되게 분할하는 방법입니다.

현실적인 N-gram 전략

추천: 2~3글자 단위 N-gram (bi-gram/tri-gram)

• 2~3자 조합만 포함,단일 글자는 제외,
• 검색어가 길든 짧든 일정한 기준으로 매칭 가능
• 중간 글자 검색도 가능

예: "히포에스테스" 2-gram → ["히포", "포에", "에스", "스테", "테스"] 3-gram → ["히포에", "포에스", "에스테", "스테스"]

N-Gram 생성 코드

List<String> _generateNGrams(String input) {
  // 1. 공백 제거
  final normalized = input.replaceAll(' ', '');
  // 2. 중복을 허용하지 않는 컬렉션 Set 생성
  final ngrams = <String>{};
  // 3. 2~3글자 단위로 N-gram 생성
  for (int n = 2; n <= 3; n++) {
    for (int i = 0; i <= normalized.length - n; i++) {
         // 4. n개씩 잘라서 추가
      ngrams.add(normalized.substring(i, i + n)); 
    }
  }
  // 5. Set → List로 변환
  return ngrams.toList();
}

substring(start, end)

• start: 시작 인덱스 (포함)
• end: 끝 인덱스 (불포함) ← 중요!

final data = doc.data();

• 해당 문서 안에 있는 모든 필드를 Map<String, dynamic> 형태로 가져오는 것

  {
  'contentNum': '18657',
  'plantName': '얼록자주달개비',
  'photoFileUrl': 'https://...',
  'createdAt': 1749982130382
  }

전체 코드

  Future<void> updatePlantsWithNGrams() async {
    DocumentSnapshot? lastDoc;
    while (true) {
      // 1. 데이터 가져오기
      final query = _plantsCollection.limit(10);
      final snapshot =
          lastDoc == null
              ? await query.get()
              : await query.startAfterDocument(lastDoc).get();
      if (snapshot.docs.isEmpty) break;
      // Firestore에서 여러 개의 .set(), .update(), .delete() 작업을 한 번에 처리하는 트랜잭션 비슷한 묶음
      final batch = FirebaseFirestore.instance.batch();
      for (final doc in snapshot.docs) {
        final data = doc.data();
        final plantName = data['plantName'] ?? '';
        final ngrams = _generateNGrams(plantName);
        // 2. Firestore에 ngrams 필드 업데이트
        batch.update(doc.reference, {'ngrams': ngrams});
      }
      // 3. 한꺼번에 commit 완료
      await batch.commit();
      lastDoc = snapshot.docs.last;
    }
    print('모든 문서에 ngrams 필드 추가 완료');
  }

[에러 상황] 회사에서 프로젝트를 진행 하던 중, 리스트 뷰에서 GetXController를 update하는 구문을 호출하였더니, 에러가 발생했다

• 전체 코드

  child: ListView.builder(
        itemCount: controller.enterpriseList.length,
        itemBuilder: (context, index) {
           if (controller.hasMore == true && !controller.isLoading &&
                  index == controller.enterpriseList.length - 1) 
               // 이렇게 바로 실행하면 에러
               SdmSearchController.find().search(searchTerm: controller.searchTerm ?? '');
               return Center(
                   child: CircularProgressIndicator(
                   color: AppTheme.colors.pink,
                   strokeWidth: 2,
                 ));
               }

  • 에러 발생한 이유

  • 무한 루프나 논리 충돌이 발생할 수 있어서 Flutter가 예외로 막아 놓았기 때문
• 해결법
  • Future.microtask()로 감싸기
• 에러가 안 나는 이유 Flutter의 build phase가 끝난 직후(=마이크로태스크 큐)에 controller.update()를 실행하게 되기 때문

🔍 개념 정리 build() 중에 update() 호출 -> 에러 발생 : 현재 화면을 그리고 있는 중에 다시 그리라고 하면 안 됨 Future.microtask(() => controller.update()) : build가 끝난 직후, 마이크로태스크 큐에 실행되니까 안전

📌 Future.microtask() 지금 실행중인 동기 작업이 끝나자마자 바로 실행되는 비동기 함수

즉, build() 함수가 지금 당장 실행되고 있는 중이라면,

controller.update(); // 에러 발생

하지만,

Future.microtask(() => controller.update()); // 저장해놨다가 바로 실행

Flutter가 build phase를 마치고 난 직후, 즉 다음 이벤트 루프 사이클 전에 update()를 실행하기 때문에 안전하게 UI를 갱신할 수 있다.

회사에서 프로젝트를 진행하던 도중, 어떤 화면에 진입했을때 화면이 다 빌드되고 나서 화면의 최하단으로 스크롤이 이동해야하는 케이스가 생겨 알아보다가 정리하게 되었다

해야하는 작업

1. 위젯이 다 빌드 되었는지 확인 - 스크롤 컨트롤러가 위젯에 attach 됐는지 확인하기 위해
2. 스크롤 컨트롤러 position 이동

1. 위젯이 다 빌드 되었는지 확인 WidgetsBinding.instance.addPostFrameCallback((_) {});

• 위젯 트리가 다 빌드 되고, 첫 프레임이 렌더링된 후 한번만 실행되는 콜백 함수

2. 스크롤 컨트롤러 position 이동 scrollController.animateTo( scrollController.position.maxScrollExtent, duration: const Duration(milliseconds: 1000), curve: Curves.easeInOut, );

• position.maxScrollExtent : 스크롤이 닿을수 있는 전체 영역 중에서 가장 아래(끝)의 위치 값
• anmateTo() : 스크롤을 해당되는 위치까지 이동시켜주는 함수

전체 코드

  @override
  void onInit() {
    isLoading = true;
    update();
    Future.wait([
      loadPost(),
      loadCommentList(),
    ]).then((_) {
      WidgetsBinding.instance.addPostFrameCallback((_) {
        if (moveToComment == true && scrollController.hasClients) {
          scrollController.animateTo(
            scrollController.position.maxScrollExtent,
            duration: const Duration(milliseconds: 1000),
            curve: Curves.easeInOut,
          );
        }
      });
      isLoading = false;
      update();
    });
    super.onInit();
  }

WidgetsFlutterBinding

• WidgetsFlutterBinding runApp() 호출 시 자동으로 생성되어, Flutter 앱의 위젯 바인딩과 렌더링 시스템을 초기화하는 클래스 일반적인 경우에는 명시적으로 사용할 필요가 없지만, main() 함수에서 비동기 작업(예: Firebase 초기화 등)을 수행해야 할 때는, WidgetsFlutterBinding.ensureInitialized()를 호출해 바인딩을 수동으로 초기화해야 한다. 이 메서드는 바인딩이 아직 없다면 새로 생성하고, 이미 있는 경우 기존 인스턴스를 반환하여 Flutter 엔진이 완전히 초기화되도록 보장한다.

info.plist

    <key>CFBundleName</key>
    <string>원하는 이름</string>

[Android]

    <application
        android:label="원하는 이름"
        android:name="${applicationName}"
        android:icon="@mipmap/ic_launcher">

• pub.dev 링크 https://pub.dev/packages/firebase_analytics

1. 기본 설정

1. Firebase에 내 어플리케이션을 등록한다 (생략)
2. pubspec.yaml에 firebase_analytics 의존성을 추가한다

   firebase_analytics: ^11.4.5

2. 추가 기능

FirebaseAnalytics.instance 와 FirebaseAnalyticsObserver()를 사용하여 이벤트를 추적할수도 있다 (직접 사용하지 않은 기능이라 정리 X)

class App extends StatelessWidget {
  static FirebaseAnalytics analytics = FirebaseAnalytics.instance;
  static FirebaseAnalyticsObserver observer = FirebaseAnalyticsObserver(analytics: analytics);

  const App({super.key});

  @override
  Widget build(BuildContext context) {
    return GetMaterialApp(
      navigatorObservers: <NavigatorObserver>[observer],
      getPages: [
        GetPage(
          name: '/comments/:id',
          page: () {
            final id = Get.parameters['id']!;
            return CommentDetail(id: id);
          },
        ),
...생략

3. Debug View로 확인하기

Firebase Console 특성상 analytics 대시보드에 실시간으로 현황이 업데이트 되지 않을 수도 있는데, analytics의 기능이 제대로 실행되고 있는지 디버그뷰를 활용하면 추적할 수 있다

디버그뷰에 기기 등록 하는 법

1. Android

• 원래는 abd 환경변수 설정을 해줘야 하는데, 하지 않아도 사용할수 있는 방법이 있다

  1. 터미널에 아래 명령어 입력하면, adb 사용 가능 cd ~/Library/Android/sdk/platform-tools
  2. 이후 코드도 동일하게 입력 adb shell setprop debug.firebase.analytics.app 패키지명

• 이후, 안드로이드 기기 디버그 시작 시 디버그뷰에서 확인할 수 있다

2. iOS

• Xcode > Runner > Edit Scheme...
• Arguments Passed On Launch + > -FIRDebugEnabled 입력
• 이후, 안드로이드와 동일하게 기기 디버그 시작 시 디버그뷰에서 확인할 수 있다

• npm 설치

  npm install next@latest react@latest react-dom@latest

Flutter의 패키지 중 image_picker 라는 패키지를 사용하여 카메라와 갤러리에 접근해서 사진을 불러오는 기능을 구현하려고 한다 먼저, iOS와 Android에서 카메라 및 갤러리에 접근하려면 별도의 접근 권한이 필요하다

iOS

접근 권한 추가

• ios > Runner > Info.plist 코드 추가

    <key>NSCameraUsageDescription</key>
    <string>Access to the camera is required for image search.</string>
    <key>NSPhotoLibraryUsageDescription</key>
    <string>Access to the photo library is required for image search.</string>

• ios > Podfile 코드 추가

  post_install do |installer|
  installer.pods_project.targets.each do |target|
    flutter_additional_ios_build_settings(target)
  end
  
  target.build_configurations.each do |config|
    config.build_settings['GCC_PREPROCESSOR_DEFINITIONS'] ||= [
      '$(inherited)',
      'PERMISSION_PHOTOS=1', # 사진 라이브러리 권한 플래그 설정
      'PERMISSION_CAMERA=1', # 카메라 권한 플래그 설정 
    ]
  end
  end

Android

접근 권한 추가

• Android 13 이상부터 더이상 카메라 갤러리 권한 요청이 필수가 아니게 되었다
• android > app > src > main > AndroidManifest.xml 코드 추가

  <manifest xmlns:android="http://schemas.android.com/apk/res/android">
    <!-- 인터넷 -->
    <uses-permission android:name="android.permission.INTERNET"/>
    <!-- Android 12 이하 -->
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
  

```

참고

• permission_handler Enum 정리

ValueChanged<T>? functionName;

• 하나의 인자(T 타입)를 받고 void 값을 반환하는 콜백 타입으로, Flutter에서 미리 정의된 함수 타입(Function typedef) 중 하나. 위젯에서 상태 변경 시 부모에게 알려줄 때 자주 쓰임

https://pub.dev/packages/timeago

사용 방법

1. 의존성 추가

- pubspec.yaml에 아래 코드 추가

timeago: ^3.7.0

2. 예시

• import import 'package:timeago/timeago.dart' as timeago;

• 코드 ```dart static Widget requestInfo(PostModel post) {

  // locale 설정

  timeago.setLocaleMessages('ko', timeago.KoMessages()); DateTime createdDate = DateTime.fromMillisecondsSinceEpoch(post.createdAt); return Row(

  children: [
    const SizedBox(width: 5),
    Container(
      width: 4,
      height: 4,
      decoration: BoxDecoration(
        color: const Color(0xFFFF0000),
        borderRadius: BorderRadius.circular(100),
      ),
    ),
    const SizedBox(width: 12),
    Expanded(
      child: Text(
        post.title,
        maxLines: 1,
        overflow: TextOverflow.ellipsis,
      ),
    ),
    const SizedBox(width: 25),
    Text(timeago.format(createdDate, locale: 'ko')),
    const SizedBox(width: 5),
  ],

  ); }```

비동기 작업(Future)이 끝날 때까지 기다렸다가, 결과에 따라 UI를 바꿔주는 Flutter 위젯

• 주로, 데이터를 파일에서 읽거나, 인터넷에서 받아올 때 사용

구조

FutureBuilder<T>(
  future: someFuture,
  builder: (context, snapshot) {
    // snapshot 안에 결과, 상태, 오류 정보가 들어 있음
  },
)

snapshot

비동기 처리 중 생기는 데이터의 상태와 결과를 담고 있는 객체 FutureBuilder나 StreamBuilder에서 builder 함수의 인자로 전달

🔍 snapshot 속성 정리

flutter_oss_licenses

사용 방법

1. 의존성 추가

- pubspec.yaml에 아래 코드 추가

flutter_oss_licenses: ^3.0.4

2. json 파일 생성

• flutter_oss_licenses 3.0.0 이후부터는 .json 출력만 지원하고,
• --text*나** --markdown** 옵션은 더 이상 지원해주지 않음

  run flutter_oss_licenses:generate -o assets/json/licenses.json --json

• 내가 지정한 폴더 경로에 오픈소스 json 파일이 생성된다

3. 예시

json 파일 활용해서 자유롭게 화면 구현하기

1. pubspec.yaml 등록하기

flutter:
  uses-material-design: true
  assets:
    - assets/
    - assets/json/licenses.json

2. 화면 구현 예시

import 'dart:convert';
import 'package:flutter/material.dart';
import 'package:flutter/services.dart' show rootBundle;
import 'package:marrying_flutter/app_theme.dart';

class SettingLicenses extends StatelessWidget {
  const SettingLicenses({super.key});

  Future<List<Map<String, dynamic>>> loadLicenses() async {
    final jsonString = await rootBundle.loadString('assets/json/licenses.json');
    final List<dynamic> jsonData = json.decode(jsonString);
    return jsonData.map((e) => e as Map<String, dynamic>).toList();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('오픈소스 라이센스')),
      body: FutureBuilder<List<Map<String, dynamic>>>(
        future: loadLicenses(),
        builder: (context, snapshot) {
          if (!snapshot.hasData) {
            return Center(
                child: CircularProgressIndicator(
              color: AppThemeColors().pink,
              strokeWidth: 2,
            ));
          }
          final licenses = snapshot.data!;

          return ListView.separated(
            padding: const EdgeInsets.all(16),
            itemCount: licenses.length,
            separatorBuilder: (_, __) => Divider(
              color: AppThemeColors().divider,
            ),
            itemBuilder: (context, index) {
              final license = licenses[index];
              final name = license['name'] ?? 'Unknown';
              final homepage = license['homepage'] ?? license['repository'];

              return ListTile(
                title: Text(
                  name,
                  style: TextStyle(fontSize: 15, fontWeight: AppThemeFontWeights().medium),
                ),
                subtitle: homepage != null
                    ? Text(
                        homepage,
                        style: TextStyle(color: AppThemeColors().grey73),
                      )
                    : null,
              );
            },
          );
        },
      ),
    );
  }
}

• [firebase Core] 아직 앱이 구성되지 않았다는 디버그 코드가 출력됨

  [[FirebaseCore]] 11.6.0 - [FirebaseCore][I-COR000005] No app has been configured yet.

해결 방법

• ios > AppDelegate.swift 코드 추가

  import Firebase
  
  @main
  @objc class AppDelegate: FlutterAppDelegate {
    override func application(
      _ application: UIApplication,
      didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {
      **FirebaseApp.configure()**
      GeneratedPluginRegistrant.register(with: self)
      return super.application(application, didFinishLaunchingWithOptions: launchOptions)
    }
    ...

• xcode 버전 업데이트 이후, 갑자기 FirebaseMessaging 모듈이 없다고 빌드가 되지 않는 에러 발생

  Failed to build iOS app

• • Swift Compiler Error (Xcode): No such module 'FirebaseMessaging'** /Users/seeun/projects/marrying-flutter/ios/ImageNotification/NotificationService.swift:8:7 Encountered error while building for device.

해결 방법

• ios > podfile 코드 추가

    target 'ImageNotification' do
      use_frameworks!
      pod 'Firebase/Messaging'
    end

네이버 로그인 연동은 Firebase 공식 지원 패키지가 아닌 서드파티 패키지이므로, 직접 구축한 서버에서 Custom Token을 발급 받을 수 있어야 합니다.

사용한 플러그인

flutter_naver_login : https://pub.dev/packages/flutter_naver_login

Android 설정

1. app > src > main > res > strings.xml 파일 추가

    <?xml version="1.0" encoding="utf-8"?>
    <resources>
        <string name="client_id">client_id</string>
        <string name="client_secret">client_secret</string>
        <string name="client_name">client_name</string>
    </resources>

• 본인이 설정한 naverConsumerKey naverConsumerSecret naverServiceAppName naverServiceAppName naverServiceAppUrlScheme 을 <string></string> 사이에 넣기

2. AndroidMenifest.xml 수정

    <manifest xmlns:android="http://schemas.android.com/apk/res/android">
        <uses-permission android:name="android.permission.INTERNET"/>
        <application
            android:label="${라벨이름}"
            android:name="${applicationName}"
            android:icon="@mipmap/ic_launcher">
            <!--meta-data 추가-->
           <meta-data
               android:name="com.naver.sdk.clientId"
               android:value="@string/client_id" />
            <meta-data
               android:name="com.naver.sdk.clientSecret"
               android:value="@string/client_secret" />
            <meta-data
               android:name="com.naver.sdk.clientName"
               android:value="@string/client_name" />
            <activity
                      ...

3. 문제 상황

[이슈 상황] kotiln과 java 컴파일러의 버전 호환성 에러 발생 [해결 방법]

• settings.gradle 수정

  plugins {
     id "dev.flutter.flutter-plugin-loader" version "1.0.0"
     id "com.android.application" version "8.1.0" apply false
     // START: FlutterFire Configuration
    id "com.google.gms.google-services" version "4.3.15" apply false
    // END: FlutterFire Configuration
    // id "org.jetbrains.kotlin.android" version 
    **"1.8.22"** apply false
    // flutter_naver_login ^2.0.0. 호환시키기 위해 버전 변경
    id "org.jetbrains.kotlin.android" version **"2.0.21"** apply false
   }

iOS 설정

1. info.plist 수정

  <!--array에 추가-->
  <dict>
          <key>CFBundleTypeRole</key>
          <string>Editor</string>
          <key>CFBundleURLSchemes</key>
          <array>
              <string>com.temp.test</string>
          </array>
      </dict>
     ...
    <!--가장 하단에 추가-->
    <key>naverConsumerKey</key>
    <string>$ConsumerKey</string>
    <key>naverConsumerSecret</key>
    <string>$ConsumerSecret</string>
    <key>naverServiceAppName</key>
    <string>$AppName</string>
    <key>naverServiceAppUrlScheme</key>
    <string>$AppUrlScheme</string>

• 본인이 설정한 naverConsumerKey naverConsumerSecret naverServiceAppName naverServiceAppName naverServiceAppUrlScheme 을 <string></string> 사이에 넣기

  2. AppDelegate.swift 수정

    ...
    import NaverThirdPartyLogin

      // 가장 하단에 추가
      override func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {
          var applicationResult = false
          if (!applicationResult) {
             applicationResult = NaverThirdPartyLoginConnection.getSharedInstance().application(app, open: url, options: options)
          }
          // if you use other application url process, please add code here.

          if (!applicationResult) {
             applicationResult = super.application(app, open: url, options: options)
          }
          return applicationResult
      }

코드 구현 예시

• pubspec.yaml 수정

  flutter_naver_login: ^2.0.0 # 플러그인 추가

• signinWithNaver()

  signinWithNaver() {
    IndicatorClient.instance.show();
    return FirebaseClient.auth.signinWithNaver().then((_) {
      return NetworkClient.auth.create('naver').then((_) {
        IndicatorClient.instance.hide();
        BaseNavigator.reset(const SplashRoute());
      });
    }).catchError((e) {
      // print(e);
      IndicatorClient.instance.hide();
      if (e == 'error') {
        BaseDialog.showToast('로그인이 취소되었습니다');
        return;
      }
      BaseDialog.showToast('오류가 발생했습니다');
    });
  }

1. 명령어

• macOS 또는 Linux

  keytool -genkey -v -keystore ~/upload-keystore.jks -keyalg RSA \

    -keysize 2048 -validity 10000 -alias upload

• Windows > PowerShell

  keytool -genkey -v -keystore $env:USERPROFILE\upload-keystore.jks -storetype JKS -keyalg RSA -keysize 2048 -validity 10000 -alias upload

2. 인증 절차

• 모든 항목을 입력하지 않아도 됨

• 두 자리 국가 코드는 대한민국이므로 "82"

• upload에 대한 키 비밀번호 입력

  • Enter를 누르시면 위에서 입력한 키 저장소 비밀번호/새 비밀번호 항목에 입력한 비밀번호와 동일하게 설정
  • 비밀번호의 경우, 추후 앱 서명시 필요. 잊어버리지 않도록 주의 → company명 (pillgood) 으로 설정

• .jks 파일 → android 하위 디렉토리 > import

  • import 하는건지 자동생성 되는건지 다음 프로젝트 때 확인 필요

2. 앱에서 키스토어 참조

1. keystoreProperties 파일을 로드할 객체 설정

• android > key.properties 파일 추가
  

  storePassword=... keyPassword=... keyAlias=... storeFile= ...-keystore.jks

3. Gradle에서 로그인 구성

• 서명 구성 추가
  • android > app > build.gradle 수정

    # 속성 블록 전에 키스토어 속성 파일을 정의하고 로드
    def keystoreProperties = new Properties()
    def keystorePropertiesFile = rootProject.file('key.properties')
    if (keystorePropertiesFile.exists()) {
       keystoreProperties.load(new FileInputStream(keystorePropertiesFile))
    }
    ...
    # buildTypes속성 블록 내부의 속성 블록 앞
    signingConfigs {
        release {
            keyAlias keystoreProperties['keyAlias']
            keyPassword keystoreProperties['keyPassword']
            storeFile keystoreProperties['storeFile'] ? file(keystoreProperties['storeFile']) : null
            storePassword keystoreProperties['storePassword']
        }
    }

4. 앱 매니페스트 검토

• 앱 매니페스트 검토

5. Gradle 빌드 구성 검토 및 변경

• Gradle 빌드 구성 검토 및 변경

6. build.gradle 속성 조정

• 속성

  재산	목적	기본값
  compileSdk	앱이 컴파일되는 Android API 수준입니다. 이는 사용 가능한 가장 높은 버전이어야 합니다. 이 속성을 로 설정하면 앱이 에 특정한 API를 사용하지 않는 한 31API 또는 이전 버전을 실행하는 기기에서 앱을 실행합니다 .3031
  defaultConfig
  .applicationId	앱을 식별하는 최종 고유 애플리케이션 ID입니다 .
  .minSdk	앱이 실행되도록 설계한 최소 Android API 레벨 입니다.	flutter.minSdkVersion
  .targetSdk	앱 실행을 테스트한 Android API 레벨입니다. 앱은 이 레벨까지의 모든 Android API 레벨에서 실행되어야 합니다.	flutter.targetSdkVersion
  .versionCode	내부 버전 번호를 설정하는 양의 정수 . 이 번호는 어느 버전이 다른 버전보다 최신인지만 결정합니다. 숫자가 클수록 최신 버전을 나타냅니다. 앱 사용자는 이 값을 절대 보지 못합니다.
  .versionName	앱이 버전 번호로 표시하는 문자열입니다. 이 속성을 원시 문자열 또는 문자열 리소스에 대한 참조로 설정합니다.
  .buildToolsVersion	Gradle 플러그인은 프로젝트에서 사용하는 Android 빌드 도구의 기본 버전을 지정합니다. 빌드 도구의 다른 버전을 지정하려면 이 값을 변경합니다.

flutter proejct 재구성

• 다음과 같이 변경하면, 캐시된 빌드로 인해 서명 프로레스에 영향을 미칠 수도 있으므로, 다음 명령문을 통해, flutter proejct 재구성하기 - flutter clean flutter pub get

해시 키 추출

• release key

  keytool -list -v -alias {aliasName} -keystore {keystoreName}.jks

• Terminal > aliasName 과 keystoreName에 내가 설정한 대로 변경 후, 코드 입력하면 SHA-1 키가 추출됨

• SHA-1 키 변환

  $ echo {SHA-1} | xxd -r -p | openssl base64

• 추출된 해시 키 - Firebase 및 kakao developer 해시 키 추가 필수 !

• Google play console

  • goole play console 안드로이드 릴리즈 해시 키 업로드 - google play console 서명 키 Firebase 및 kakao developer에 추가하기

1. XCode 에서 Bundle ID 확인

2. Apple developer에서 App ID 등록

• Certificates, Identifiers & Profiles : Identifiers > + 버튼 클릭

    - Desription/BundleID 입력

  

2. App Store Connect 앱 등록

• App Store Connet > 앱 > + 버튼 클릭

  -이름 : 앱 이름 -기본 언어 : 기본 언어 선택 -번들 ID : 앱 번들 ID 입력 -SKU : 사용자에게 표시되지 않는 앱의 고유한 ID

3. Xcode 설정 검토

• https://docs.flutter.dev/deployment/ios#review-xcode-project-settings

4. 앱 배포 버전 업데이트

• Deployment TargetXcode 프로젝트에서 변경한 경우, ios/Flutter/AppframeworkInfo.plistFlutter 앱에서 열고, MinimumOSVersion값을 일치하도록 업데이트

5. 앱 아이콘 추가

• https://developer.apple.com/design/human-interface-guidelines/app-icons/

6. 출시 이미지 추가

• Xcode 프로젝트 탐색기에서 폴더 Assets.xcassetsRunner 선택
• 'placeholder launch image' 를 원하는 이미지로 변경
• 앱 hot restart > 새로운 시작 이미지를 확인

7. 앱의 빌드 및 버전 번호 업데이트

• 앱의 기본 버전 번호는 1.0.0
• 한번 빌드 할때 마다, +1씩 해줘야함

    # pubspec.yaml
    version: 1.0.0+1

• 버전번호 : MAJOR(주 버전) . MINOR(부 버전) . PATCH(수정 버전)

8. 앱 번들 만들기

• VSCode > Terminal > flutter build ios
• Xcode > Product > Archive 진행

9. 앱 번들 업로드

• 빌드와 함께 ipa 파일 생성, Organizer 화면 표시
• 버전 업데이트 됐는지 확인 필수!
• App Store Connect → Distribute
• App Store Connect에 등록됨 (약간의 시간 소요, 진행 상황 메일로 확인 가능)

1. Firebase 설정

• Authentication > 로그인 방법 > 새 제공 업체 추가

2. Xcode 설정

1. Runner > Signing & Capabilities
2. Team 설정하고, build 진행 → identifier 생성
3. +Capability 클릭 > Sign in with Apple 추가
   

3. Apple Developer 설정

• [Identifiers] App IDs 등록
  1. Register a new identifier
  2. Select a type
  3. Register an App ID > Capabilities : Sign In with Apple 활성화

4. Edit

• Enable as a primary App ID 선택 확인
• Server-to-Server Notification Endpoint : Firebase apple 로그인 콜백 URL 넣기

2. [Keys] 새로운 키 생성

1. Sign in with Apple 추가 후 저장

2. Sign in with Apple > Edit

• 방금 생성한 app id 선택 후 Save
• P8 파일 다운로드 후, Firebase 비공개 키에 저장
• 해당 파일은 터미널에서 cat ~, 또는 Chrome에 가져가면 내부 코드 확인 가능

3. [Identifiers] Service IDs 등록

• Description 입력
• Identifier : Bundle ID 역순으로 입력

  ex)

• Bundle ID : com.temp.test
• Identifier : test.temp.com

• Sign in with Apple 선택 후, Configure 선택
  • 일치하는 Primary App Id 선택 후, Website URLs 작성
  • domain에는 Firebase에서 제공된 Callback URL의 도메인만 입력
  • Returns URLs 에는 callbackURL 전체 입력

3. Firebase Console 설정

• Authentication > 로그인 방법 > 새 제공업체 추가 > Apple 추가

  • 안드로이드 애플 로그인을 위해, OAuth 코드 흐름 구성 설정

    1. Apple 팀 ID 입력 : Apple Developer 주식회사 이름 뒤에 있는 문자
    2. 키 ID 입력
    3. 비공개 키 입력

    -Apple Developer 설정 > [Keys] 새로운 키 생성 에서 다운 받은 키
    

4. Android 설정

[이슈 상황] 안드로이드 - 네이버 앱 apple 로그인 시, 네이버 앱이 백그라운드로 돌아가지 않는 이슈 발생

[해결 방법]

• AndroidManifest.xml 수정

    <!-- taskAffinity="" 에서 테스크 이름 설정해줌 -->
    <activity
        android:name=".MainActivity"
        android:exported="true"
        android:launchMode="singleTop"
        android:taskAffinity=""
        android:theme="@style/LaunchTheme"
        android:configChanges="orientation|keyboardHidden|keyboard|screenSize|smallestScreenSize|locale|layoutDirection|fontScale|screenLayout|density|uiMode"
        android:hardwareAccelerated="true"
        android:windowSoftInputMode="adjustResize">

코드 구현 예시

Future<UserCredential> signInWithApple() async {
  AppleAuthProvider appleProvider =
      AppleAuthProvider().addScope('email').addScope('name');
  UserCredential userCredential =
      await FirebaseAuth.instance.signInWithProvider(appleProvider);
  return userCredential;
}

🔗 Ref

• https://wlrn566.tistory.com/141 https://medium.com/@saqwzx88/%EC%95%A1%ED%8B%B0%EB%B9%84%ED%8B%B0-%EC%8A%A4%ED%83%9D-%EA%B4%80%EB%A6%AC-3e5219510ac7
• https://medium.com/@saqwzx88/%EC%95%A1%ED%8B%B0%EB%B9%84%ED%8B%B0-%EC%8A%A4%ED%83%9D-%EA%B4%80%EB%A6%AC-3e5219510ac7