EEYatHo 앱 깎는 이야기

2025 서울 바베큐 페스타 후기

EEYatHo — Sat, 25 Oct 2025 17:48:53 +0900

2025 서울 바베큐 페스타에 다녀왔어요

내일(10/26)에 가시는 분들 도움되실까봐 후딱 남겨요!

기왕이면 맹꽁이 버스를 타려했는데,

행사장소인 노을캠핑장으로 가는 맹꽁이 버스는 주차장에서만 운행하더라구요..?

퀸즈스마일 앱으로 셔틀버스 예매하고,

월드컵경기장 역으로 출발했습니다

(셔틀버스 인당 3000원. 맹꽁이랑 달리 강아지 추가 요금 없음)

월드컵경기장역에서 셔틀버스 타는 곳까지.

약 10분정도 걸어갔고,

셔틀버스 타고 7분정도 더 가서,

행사장소 근처인 월드컵파크골프장에 내렸어요

셔틀버스 내리자마자 산 위라 그런지

공기나 뷰가 모두 좋았어요!

그리고 산책로 따라 조금만 더(5분?)

걸어 들어가면 행사장이 나와요~

날씨 좋고, 탁 트인 곳에, 사람들 적당히 왁자지껄

고기 향기도 솔솔나니 기분이 너무 좋아지더라구요

나무 평상이나, 드럼통 테이블이 있어서 몸만왔는데,

피크닉 매트를 무료로 대여해주시더라구요?

가까이서 버스킹 즐기려고 대여했어요

이름이랑 전화번호 쓰고 수령하고, 2시간 내에 반납.

혹은 그냥 와서 2시간씩 연장해도 됩니다.

크기는 성인 둘이 앉는 정도에요

(눕는건 불가)

음식은 중간에 있는 키오스크에서 결제하고, 가게들에서 음식 수령하는 구조에요

퀸즈스마일 앱에서 고기 3대장 음식들 예약 되던데,

직접와서 보고 고르고 싶어서 그냥 왔어요

왼쪽이 주먹고기 (9000원)

오른쪽이 소시지 (4000원), 껍데기 (4000원)

먹고싶은거 고르다보니 전부 뭉텅에서 샀네요

맛 최고

불맛 제대로

3대장 가게들 가격보다 훨씬 저렴해서 놀랐는데,

맛도 너무 만족스러웠어요

3대장 가게 메뉴는 라면도 6000원 이던데,

직접 와보니 2500원도 있네요

다들 느끼한 고기 드시다보니 라면 인기 폭발~

버스킹 보고 들으면서 여유롭게 먹었습니다

배도 채웠겠다

축제 규모가 워낙 크다보니, 여기저기 돌아다니기 시작했어요

K-바베큐로드 가운데 부분.

30분 간격으로 한우 시식회도 열리더라구요

시간마다 메뉴가 달랐어요, 불고기, 채끝, 꼬치 등

시간마다 50명, 30명 등 제한

특정 시간은 게임을 진행해서 사회자를 이겨야 먹을 수 있었어요

(왜 사진 안찍었지 ㅠ)

저희는 13시에 갔고, 인스타 팔로우 & 카톡 친추하고 불고기 얻어먹었어요

그 외에도

1. 인스타 작성시 카카오 프렌즈에서 스티커카드, 마스크 팩을 받을 수 있었고

2. 인스타 팔로우시, 비락 식혜 (오리지널 or 제로)

3. 설문조사 작성시 무알콜 맥주

를 받을 수 있었어요~

정말 퍼주는 축제 같았어요

(사진 좀더 많이 찍을걸..)

심지어 노을라운지 내, 노을야외도서관 이라는 곳에서

야외 독서 키트(?)를 2시간씩 대여 해주시더라구요

이름과 전화번호만 쓰고 2시간 대여하고,

담요와 좌식의자 덕에 정말 편하고 여유롭게 독서도 하고 왔어요

주변에 가족단위의 애들과 반려견도 많고,

야외에서 편한 자세로 힐링되는 책을 보고있는데 이게 다 공짜라고?

이렇게 누려도 되나 싶었습니다..

그리고 1.5권정도 읽다가 다시 일어났어요

노을 라운지도 넓어서

커피나 견과류, 여러 농수산물 파는 곳도 있었고,

6.69초(bbq)를 맞춰서 타이머를 멈춰야하는 미니게임도 할 수 있었어요.

저희는 둘다 0.1초 차이로 실패.. (6.59, 6.79)

서울 고깃집 3대장 구역이에요

고기 굽는 연기 모락모락나고

다양한 사람들이 고기와 술을 즐기는 모습

대충 다 본거같고~

저녁되면 사람도 많아질거고

좀 쌀쌀해서 얼른 튀튀

셔틀버스 타러 가는 길에,

지도에 명칭되지 않은 넓은 부지가 있어서 들어가봤더니

웨딩촬영 성지였네요 ㄷㄷ

무려 8커플이나 웨딩촬영을 하고 있었습니다

셔틀버스 똑같이 타서 내려오고,

다시역으로 걸어가는 중,

큰 시장 건물이 보여 들어갔어요

아니 근데 저 회를 만원에 파시더라구요?!

집에서 위스키랑 먹으려고 사왔어요

오늘 저녁에 해치울 예정 ㅎ

그럼 이만

즐거운 주말 되세요!

Mac ) 메모리(ram) 사용량 확인

EEYatHo — Mon, 1 Sep 2025 13:37:37 +0900

1. 활성 상태 보기(Activity Monitor)로 확인

맥에서 가장 직관적인 방법은 활성 상태 보기 앱을 활용하는 것

실행 방법

Spotlight(⌘ + Space)을 열고 활성 상태 보기 검색

메모리 탭 확인

상단 탭에서 메모리를 클릭
하단에는 메모리 압력 그래프가 표시되며, 초록색이면 여유가 있고, 노란색/빨간색으로 갈수록 메모리가 부족

2. 터미널 명령어로 확인하기

터미널에서도 멋있게(?) 메모리 상태 확인 가능

1. vm_stat 명령어

vm_stat

페이지 단위로 메모리 상태가 출력 (Pages free, Pages active, Pages inactive, Pages wired down 등)
단위가 페이지(4KB).. 복잡한 계산 필요

2. top 명령어

top -l 1 | grep PhysMem

현재 메모리 사용량을 직관적으로 확인

3. htop (추가 설치 필요)

brew install htop
htop

Homebrew로 htop을 설치하면 멋있는 인터페이스로 CPU/메모리 사용량 확인

3. 메뉴 막대에서 간단히 확인하기

앱스토어에서 앱을 설치해, 메뉴 막대에서 메모리 사용량을 실시간으로 볼 수도 있습니다.

대표적인 앱: RunCat, iStat Menus
시스템 리소스를 지속적으로 모니터링해야 한다면 추천

YOLO 논문(2016/5) 중요부분 정리

EEYatHo — Mon, 25 Aug 2025 13:33:11 +0900

2016/05/9에 작성된 YOLO 논문 중요부분 정리

1. YOLO 개요, 특징

YOLO(You Only Look Once)는 실시간 객체 검출을 위한 새로운 방법 (지금은 평범한 방법)
- 기존 방법들은 분류기(classifier)를 재활용하여 검출하는 방식을 사용했으나, YOLO는 객체 검출을 회귀(regression) 문제로 바라봄
전체 이미지를 한 번에 평가하여 여러 객체의 위치와 종류를 동시에 예측
- 단일 신경망이 이미지를 입력받아 여러 개의 바운딩 박스와 클래스 확률을 동시에 예측
- 이 방식은 매우 빠르며, 실시간 영상 처리에 적합
훈련 및 테스트 시 전체 이미지를 보기 때문에 클래스의 외형뿐만 아니라 맥락 정보를 암묵적으로 인코딩
- 배경에 대한 오탐률이 낮고, 작은 객체 검출에 강점
- 그러나 위치 정밀도는 다소 떨어질 수 있음 (옛날 말..)

2. YOLO 작동 원리, 구조

입력 이미지 처리: 이미지를 특정 크기로 리사이징
그리드 셀 방식: 입력 이미지를 S×S개의 격자로 나누고, 셀이 B개의 객체 검출 시도
객체 책임 할당: 객체의 중심이 특정 그리드 셀에 속하면, 해당 그리드 셀이 그 객체를 탐지할 책임

바운딩 박스 및 신뢰도 예측:
1. 각 그리드 셀은 고정적으로 B개의 [바운딩 박스와 신뢰도 점수]를 예측
2. 바운딩 박스는 중심 좌표(x,y), 너비(w), 높이(h)를 예측. (이미지 넓이 높이에 따라 정규화된 값)
3. 신뢰도 점수는 박스의 객체 존재 확률, 박스 좌표 정확도를 반영
  1. 신뢰도 공식은 Pr(Object) * IOU_truth_pred (객체가 박스에 있을 확률 * 예측 박스와 정답 박스간의 IOU)
  2. Pr(Object) : 이 박스가 객체를 포함하고 있는지 여부
    - 학습 시:
      - 정답 박스가 해당 그리드 셀 안에 있으면 Pr(Object) = 1
      - 없으면 Pr(Object) = 0
    - 테스트 시:
      - 모델이 예측한 그 박스에 객체가 있을 확률을 의미
      - softmax/로지스틱 출력을 통해 0~1 사이 값
  3. IOU_truth_pred : 예측 박스와 정답 박스간의 IOU
    - IOU(Intersection Over Union): 두 박스의 교집합 넓이 / 합집합 넓이
  4. confidence 점수 하나로 “객체 존재 + 위치 정확도”를 동시에 나타냄
    - 객체가 없으면 confidence = 0
    - 객체가 있지만 위치가 틀리면 confidence 낮음
    - 객체가 있고 위치 정확하면 confidence 높음
    - 최종 목적: 객체가 있으면 신뢰도 점수는 예측된 박스와 실제박스 간의 IOU와 같도록.

클래스 확률:
1. 각 셀은 조건부로 클래스 확률을 계산
  1. 자신이 예측한 박스에 객체가 포함되어있다고 판단할 경우에만, 특정 클래스에 속할 확률을 예측
  2. 박스가 아닌 각 셀이 계산
  3. 박스 갯수 B와 관계없이,그리드 셀당 하나의 클래스 확률 세트만 예측

최종 예측:
- 클래스 확률과, 개별 박스 신뢰도 예측을 곱하여 각 박스에 대한 클래스별 신뢰도 점수를 얻음
  1. 이 점수는 해당 클래스가 박스에 나타날 확률과 예측된 박스가 객체에 얼마나 잘 맞는지 모두 인코딩
- YOLO는 탐지를 회귀 문제로 모델링하였으며, 이미지를 S x S 그리드로 나누고, 각 그리드 셀에 대해 B개의 바운딩 박스, 해당 박스의 신뢰도 C, 클래스 확률을 예측
  이러한 예측은 S x S x (B * 5 + C) 텐서로 인코딩 됨.
- 예:
  - S=7 (7×7 그리드)
  - B=2 (박스 2개)
  - C=20 (클래스 20개, PASCAL VOC 기준)
  - 출력 텐서 크기: 7×7×(2⋅5+20)

3. 나머지는 딱히 중요하지 않음

장점과 성능, pt모델의 사전학습 방법 등..

최신 모델의 백본, 넥, 헤드 내용을 분석해서 다른 글에 정리

vcpkg로 onnxruntime-gpu 설치 시 Invalid empty pathname 에러

EEYatHo — Thu, 21 Aug 2025 14:06:04 +0900

최근에 Windows 환경에서 onnxruntime-gpu를 vcpkg로 설치하다가 꽤 황당한 문제를 겪었습니다. 동일한 문제를 만나는 분들이 있을 것 같아 기록을 남겨둡니다.

문제 상황

다음 명령어로 onnxruntime-gpu를 설치했습니다.

vcpkg install onnxruntime-gpu:x64-windows

처음에는 정상적으로 다운로드가 진행되다가, microsoft-onnxruntime-v1.19.2.tar.gz 압축을 해제하는 단계에서 에러가 발생했습니다.

CMake Error: Problem with archive_write_header(): Invalid empty pathname
CMake Error: Current file: 
CMake Error: Problem extracting tar: C:/vcpkg/downloads/microsoft-onnxruntime-v1.19.2.tar.gz

처음엔 파일이 손상된 줄 알고 downloads 폴더의 파일을 지우고 다시 받아보기도 하고, 수동으로 tar.gz를 풀어서 넣어보기도 했습니다. 하지만 계속 같은 에러가 발생했습니다.

원인 추적

검색해 보니 CMake의 libarchive가 압축을 풀 때 로캘/언어 설정 문제로 경로를 제대로 읽지 못하면, 내부적으로 "empty pathname"을 만들어 버리면서 압축 해제에 실패할 수 있다고 하더군요.

즉, 제 환경에서 Windows 시스템 언어가 한국어로 설정되어 있어서 문제가 발생한 것이었습니다.

해결 방법

시스템 언어를 영어(United States)로 변경 후 다시 시도했더니, 아무 문제 없이 설치가 진행되었습니다.

정리하자면:

vcpkg install onnxruntime-gpu:x64-windows 실행 시 Invalid empty pathname 에러가 난다면,
시스템 언어/로캘을 영어로 변경하거나,
vcpkg 디렉토리를 C:\dev\vcpkg 같이 완전히 영어 경로에 두고 시도하면 해결됩니다.

교훈

Windows 개발 환경에서 C/C++ 라이브러리 빌드 시, 로캘 문제로 의외의 오류가 발생할 수 있다.
특히 vcpkg, CMake는 아직 한글 경로나 로캘에 취약하다.
개발 환경은 가능하면 영어 경로/영어 로캘을 유지하는 것이 정신 건강에 좋다

혹시 저와 같은 문제를 겪으신 분들이 있다면, 위 방법을 시도해 보시길 바랍니다!

CMake

EEYatHo — Thu, 21 Aug 2025 10:32:01 +0900

1. CMake란 무엇인가?

CMake는 크로스 플랫폼 빌드 시스템을 생성하는 도구.
운영체제마다 빌드 방식이 다른데, CMake는 하나의 설정 파일(CMakeLists.txt)로 Linux는 Makefile, Windows는 Visual Studio 프로젝트, macOS는 Xcode 프로젝트를 자동으로 만들어줌

한 번 정의하면 어디서나 빌드 가능하게 해주는 도구

2. CMake 사용 이유

플랫폼 독립성: OS와 컴파일러에 맞는 빌드 파일 자동 생성
대규모 프로젝트 관리: 서브 프로젝트, 외부 라이브러리, 테스트 등을 체계적으로 관리
오픈소스 표준: OpenCV, LLVM, Qt 같은 대형 프로젝트들이 모두 CMake 기반

3. 기본 사용법

설치 및 실행 흐름

// CMakeLists.txt파일 위치에서 시작.
mkdir build
cd build
cmake ..   // 상위 디렉토리의 CMakeLists.txt를 읽고 빌드 파일 생성
cmake --build .   // 실제 컴파일 실행

4. CMakeLists.txt 기본 구조

cmake_minimum_required(VERSION 3.20)  # 최소 요구 버전
project(MyApp LANGUAGES CXX)          # 프로젝트 이름/언어 지정

set(CMAKE_CXX_STANDARD 17)            # C++17 사용

add_executable(myapp main.cpp foo.cpp) # 실행 파일 생성

5. 모던 CMake 핵심 개념

타깃 기반 설정

CMake 3.x부터는 **타깃 단위 관리(target_*)**가 권장

add_library(mylib src/mylib.cpp)

target_include_directories(mylib PUBLIC include)
target_compile_definitions(mylib PRIVATE DEBUG_MODE=1)
target_link_libraries(mylib PUBLIC fmt::fmt)

PRIVATE: 현재 타깃에만 적용
PUBLIC: 현재 이 타깃을 사용하는 곳에도 전파
INTERFACE: 사용자에게만 전파 (헤더 온리 라이브러리에서 유용)

6. 외부 라이브러리 연동

1) find_package

find_package(fmt CONFIG REQUIRED)
target_link_libraries(myapp PRIVATE fmt::fmt)

2) FetchContent

include(FetchContent)
FetchContent_Declare(fmt
  GIT_REPOSITORY https://github.com/fmtlib/fmt.git
  GIT_TAG 11.0.2
)
FetchContent_MakeAvailable(fmt)

7. 테스트(CTest)

enable_testing()

add_executable(mytest tests/test.cpp)
target_link_libraries(mytest PRIVATE mylib)

add_test(NAME mytest COMMAND mytest)

실행: ctest --output-on-failure

8. 설치 & 배포

install(TARGETS mylib myapp
  RUNTIME DESTINATION bin
  LIBRARY DESTINATION lib
  ARCHIVE DESTINATION lib
)
install(DIRECTORY include/ DESTINATION include)

→ cmake --install build --prefix out 로 설치 가능

9. 자주 쓰는 팁

Out-of-Source 빌드 권장: build/ 폴더 따로 두기
include_directories(), add_definitions() 전역 사용은 지양 → target_* 사용
빌드 옵션은 Generator Expression으로 관리:

target_compile_definitions(myapp PRIVATE 
  $<$<CONFIG:Debug>:DEBUG_BUILD>
)

10. 기타

작은 프로젝트에서는 간단히 add_executable, target_link_libraries만 알아도 충분
규모가 커질수록 find_package, install, CTest 같은 기능을 점진적으로 활용

Flutter ) ShoreBird 배포가이드

EEYatHo — Mon, 14 Apr 2025 16:54:02 +0900

OTA가 아닌, 새로운 버전을 스토어에 배포할 경우 shorebird Release

pubspec.yaml 에서 version 수정 후 저장 (ex. version: 1.0.0+4 -> 1.0.1+5)
- iOS의 Xcode 빌드 버전이나, Android의 local.properties 버전이 바로 바뀌지 않음
- 앞의 버전이 바뀌어도 빌드번호는 올라가야함 (Android는 중복 빌드버전 금지)
android 배포
1. shorebird release android --artifact apk 실행
  - 이 명령어 실행시 Android의 local.properties 버전이 바뀜
2. 이 파일로 Firebase App Distribution 배포 진행 build/app/outputs/apk/release/app-release.apk
3. 이 파일로 PlayStore 배포 진행 build/app/outputs/bundle/release/app-release.aab
iOS 배포
1. shorebird release ios 실행
  - 이 명령어 실행시 Xcode의 빌드 버전이 바뀜
  - Xcode15 에러 발생시, 16.1로 변경 ( sudo xcode-select -s /Applications/Xcode16.1.app/Contents/Developer )
2. build/ios/archive/Runner.xcarchive 파일 실행 (organizer 노출)
3. custom > Manage Version and Build Number 체크 해제 후 Distribute App 진행
  - https://docs.shorebird.dev/guides/submitting/app-store/

OTA 배포 할 경우, 해당 릴리즈에 Patch를 생성 (shorebird patch)

릴리즈 생성 직후는 패치할 필요 없음. 아무 패치 없는 릴리즈가 기본.

shorebird patch android
shorebird patch ios

이후 앱 실행시, 재실행 해달라는 업데이트 팝업 노출 재실행하면 Patch 적용됨
(https://eeyatho.tistory.com/302 여기 글대로 팝업노출 작업을 했을 경우.)

Shorebird 문제 생겼을 경우, flutter 기본 배포 방법

flutter build apk --release --verbose

flutter build ios --release --verbose

Flutter ) ShoreBird 활용 강제 업데이트 적용

EEYatHo — Mon, 14 Apr 2025 16:46:14 +0900

0. 개요

Shorebird는 패치를 다운로드한 후 앱을 재시작하지 않으면 최신패치가 적용되지 않음

치명적인 오류를 OTA로 급히 수정했는데, 유저에게 즉시 패치된 버전을 제공할 수 없다는 점은 큰 단점
(특히, 앱 스토어에서 처음 다운로드시, 패치가 적용되지않은 초기 release 버전을 설치)

하지만, Shorebird 상태를 관리하고 강제로 재실행시키는 로직을 추가하는 등의 커스텀이 가능

-> 그러려면, shorebird에서 제공하는 자동 업데이트를 제거하고, 커스텀하게 조절하는 부분이 필요

1. 자동 업데이트 끄기

shorebird.yaml 에서 auto_update: false

// shorebird.yaml
auto_update: false

2. shorebird_code_push 라이브러리 적용

// pubspec.yaml
# shorebird 버전 파악 및 강제 업데이트 추가를 위함
shorebird_code_push: 2.0.2

3. ShoreBird 상태를 체크하고 패치를 다운로드하는 클래스 선언

특이사항

- 롤백하는 경우 대응하기 위해, upToDate 여도 다운로드 시도

import 'package:flutter/material.dart';
import 'package:shorebird_code_push/shorebird_code_push.dart';

final class ShorebirdService {
  final _updater = ShorebirdUpdater();
  Patch? currentPatch;
  bool _needRestart = false;

  Future<bool> isNeedRestart() async {
    _needRestart = false;
    if (!_updater.isAvailable) {
      debugPrint(" ️  updater.isAvailable == false 이므로 패스");
      return false;
    }
    await _readPatch();
    await _checkForUpdate();
    return _needRestart;
  }

  Future<void> _readPatch() async {
    try {
      final currentPatch = await _updater.readCurrentPatch();
      debugPrint(" ️ 현재 패치 버전: ${currentPatch?.number}");
      this.currentPatch = currentPatch;
    } catch (error) {
      debugPrint(" ️  _readPatch Error: $error");
    }
  }

  Future<void> _checkForUpdate() async {
    try {
      debugPrint(" ️ 업데이트 필요한지 체크");
      final status = await _updater.checkForUpdate(track: UpdateTrack.stable);

      switch (status) {
        case UpdateStatus.upToDate:
          debugPrint(" ️ 최신버전이지만 롤백하는 경우도 있어서 시도해야함 (upToDate)");
          await _downloadAndUpdate();
        case UpdateStatus.outdated:
          debugPrint(" ️ 패치 다운로드 필요 (outdated)");
          await _downloadAndUpdate();
        case UpdateStatus.restartRequired:
          debugPrint(" ️ 재시작 필요 (restartRequired)");
          _needRestart = true;
        case UpdateStatus.unavailable:
          debugPrint(" ️ 불가능 (unavailable)");
      }
    } catch (error) {
      debugPrint(" ️  checkForUpdate Error: $error");
    }
  }

  Future<void> _downloadAndUpdate() async {
    try {
      // 다운로드 및 업데이트 (_updater.update 완료시, 재시작하면 되는 상태가 됨)
      await _updater.update(track: UpdateTrack.stable);
      debugPrint(" ️ 패치 다운로드 완료");
      _needRestart = true;
    } on UpdateException catch (error) {
      debugPrint(" ️  downloadPatch Error: ${error.message}");
    }
  }
}

4. 앱 시작시 체크

// iOS는 조금 오래걸리므로, await 사용 x
shorebirdService.isNeedRestart().then((isNeedRestart) {
  if (isNeedRestart) {
    showRestartDialog();
    return;
  }
});

import 'dart:io';

import 'package:flutter/material.dart';
import 'package:homeknocktown_admin/presentation/design_system/atoms/dialog/dialog.dart';
import 'package:homeknocktown_admin/route.dart';
import 'package:homeknocktown_admin/utils/local_notification.dart';

Future<dynamic> showRestartDialog() async {
  return showDialog(
      context: navigatorKey.currentContext!,
      barrierDismissible: false, // 배경 눌러도 안꺼지게
      builder: (_) {
        return PopScope(
            canPop: false,
            child: YourAwesomeDialog( /// dialog 정도는 각자 알아서 띄워주기..
                text: "개선사항을 적용할 준비가 되었어요! 앱을 재시작 해주세요.",
                confirmText: "앱 종료",
                onConfirm: () async {
                  // await showLocalNotification(1, "개선사항 반영 완료", "앱을 다시 시작하기 위해 눌러주세요!");
                  exit(0);
                }));
      });
}

보너스
- iOS는 앱에서 스스로 재시작이 불가능함.
- 로컬 푸시로 유저에게 재실행하기 좋은 UX 제공

import 'package:flutter_local_notifications/flutter_local_notifications.dart';

// 로컬 푸시 알림 보여주기
Future<void> showLocalNotification(int id, String? title, String? body) async {
  debugPrint("  showLocalNotification id: $id, title: $title, body: $body");

  await plugin.show(
    id,
    title,
    body,
    NotificationDetails(
      android: AndroidNotificationDetails(
        channel.id,
        channel.name,
        channelDescription: channel.description,
        importance: Importance.max,
        priority: Priority.high,
        icon: '@mipmap/ic_notification', // 알림 아이콘
        enableVibration: true, // 진동 활성화
        playSound: true, // 소리 활성화
        showWhen: true, // 시간 표시
      ),
    ),  );
}

Flutter ) ShoreBird 중요한 것들 정리

EEYatHo — Mon, 14 Apr 2025 16:26:24 +0900

패치가 성능에 미치는 영향

Android는 패치를 적용해도 성능에 영향을 미치지 않음. (애뮬레이터도 마찬가지)

iOS 및 macOS는 패치로직이 Android와 다름.

변경되지 않은 코드는 CPU에서 실행되고, 변경 또는 추가된 코드는 Dart 인터프리터에서 실행됨 (CPU보다 느림)

일반적으로는 이런 성능 차이를 감지할 수 없지만, 성능에 민감한 이미지 또는 대용량 데이터 처리 코드는 성능 차이가 나타날 수 있음

스테이징 패치, 스테이징 프리뷰

성능 영향을 체크하거나 기타 테스트를 위해 스테이징 패치, 스테이징 프리뷰가 존재

// 스테이징 패치 업로드
shorebird patch android --track=staging

// 스테이징 패치를 지정하여 프리뷰로 볼 수 있음
shorebird preview --staging --app-id ee322dc4-3dc2-4324-90a9-04c40a62ae76 --release-version 1.0.0+1

이후 Shorebird 콘솔에서 Go Live를 누르면 프로적션으로 승격하여 모든 기기에 OTA 적용

패치 후 스토어에서 다운받을 때 (링크)

패치를 적용해도, 스토어에서는 패치되지 않은 release를 받게됨

shorebird는 런타임에만 패치를 다운로드할 수 있기때문

따라서 패치전 버전을 원천 차단하기 위해서는, shorebird_code_push를 이용하여 패치 및 재시작이 필요할 타이밍을 파악하여, 강제로 재시작하게 하는 로직이 필요

롤백

1,2,3 패치를 진행 후 3을 롤백하면 패치3을 설치한 유저는 패치 2로 다운그레이드 됨

패치 1 밖에 없는데 롤백했을 경우, 기본 릴리즈로 다운그레이드 됨

shorebird_code_push 에서, 롤백(다운그레이드)도 그냥 update가 필요하다고 나옴

패치 무결성 및 자동 롤백

앱에 포함된 Shorebird의 Updater은, 자동 온디바이스 롤백이 포함 (오픈소스)

어떤 이유로든 패치의 해시나 서명이 일치하지 않으면 패치가 삭제되며,

어떤 이유로든 패치가 Dart 런타임에 로드되지 않으면 해당 장치에서 패치가 “불량” 표시되고 앱은 자동으로 최신 설치된 패치로 롤백됨

이것이 가능한 이유는, 이전 패치 파일은 다음 패치가 성공적으로 부팅될 때 까지 디스크에 보관되며, 부팅이 성공적으로 완료되면 패치 파일이 자동으로 정리되어 디스크 사용량을 최소화함

Crashlytics와의 통합 (패치 버전 파악하기)

Crashlytics를 사용하는 경우 Shorebird 릴리스 및 패치와 함께 바로 작동

그러나 여러 패치가 있는 경우 충돌을 일으킨 패치가 무엇인지 불분명 (Sentry도 마찬가지)

shorebird_code_push 패키지를 사용하면, 패치를 구별 가능하므로, Crashlytics 커스텀 키에 추가하면됨

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp(
    options: DefaultFirebaseOptions.currentPlatform,
  );

  final patchNumber = await ShorebirdCodePush().currentPatchNumber();

  // Add the patch number as a tag. You can use whatever name you would like
  // as the key. `$patchNumber` will be "null" if there is no patch. You may
  // wish to handle this case differently.
  FirebaseCrashlytics.instance.setCustomKey(
    'shorebird_patch_number',
    '$patchNumber',
  );
  runApp(const MyApp());
}

흔한 실수. updater.isAvailable == false인 경우

빌드 모드가 release가 아닌 debug 일때
shorebird release 명령어가 아닌 다른 방법으로 빌드되었을 때

shorebird preview 흔한 실수

내가 수정한 코드가 바로 보이는 것이 아닌, shorebird에 있는 release를 받아오는 것임.

사이드 로딩 및 MDM

스토어에 등록하여 배포하지 않고, 사이드 로딩이나 MDM으로 설치된 앱도 shorebird가 잘 동작함

아래 명령어로 shorebird가 적용된 APK를 얻을 수 있음

shorebird release android --artifact=apk

안드로이드 INTERNET 권한 필요

앱이 Shorebird 서버와 통신하여 패치를 다운로드할 수 있도록 하는 데 필요

shorebird init 명령어는 이 권한이 없으면 자동으로 추가해주기에 신경x

// android/app/src/main/AndroidManifest.xml 

<manifest ...>
<uses-permission android:name="android.permission.INTERNET" />
...
</manifest>

프로젝트를 다시 초기화 하고싶다면

shorebird init --force 명령어를 사용

shorebird.yaml에 새로운 app과 app_id를 만듦

기존 앱은 향을 받지 않음

iOS preview가 안된다면

기존에 깔려있던 앱을 삭제하고 시도

새로운 위젯 추가, 새로운 라우팅 추가 다 잘 되는가?

실헝해보니 iOS, Android 다 잘됨

Flutter ) CodePush(ShoreBird) 개요

EEYatHo — Mon, 14 Apr 2025 16:22:01 +0900

문서 링크

코드푸시 동작 방식

Shorebird로 빌드된 앱에는 수정된 Flutter 엔진이 포함 (즉, 배포시 shorebird 명령어로 빌드해야함)
앱 시작 시 앱의 Dart 코드에 대한 업데이트를 확인
업데이트가 있으면 엔진이 업데이트를 다운로드
사용자는 업데이트가 다운로드된 후 앱을 다시 시작할 때 업데이트를 볼 수 있음

일반적인 코드 푸시 워크플로

(사전작업) Shorebird CLI를 사용하여 앱의 새로운 릴리스를 빌드
shorebird release android // ios
(사전작업) App Store나 Google Play를 통해 해당 릴리스를 배포
Code Push가 필요해져서 앱의 Dart 코드를 변경
1. UI뿐 아니라, 새로운 기능, 버그 수정, 업데이트 된 Dart 종속성도 포함
Shorebird CLI를 사용하여 첫 번째 단계에서 만든 릴리스에 대한 새 패치 업로드
shorebird patch android // ios
사용자는 다음에 앱을 다시 시작할 때 업데이트를 볼 수 있음

* 커스텀 배포 가이드

패치란 (링크)

사용자가 새 버전을 다운로드/업데이트 할 필요없이 앱 코드를 업데이트하는 프로세스

패치에 어떤 변경 사항이 포함될 수 있는가? (링크)

모든 Dart 코드들

앱 코드
생성된 코드
pubspec.yaml (네이티브 코드 변경 사항을 포함하지 않는 경우만)

다음은 포함되지 않음

이미지, 글꼴 등 asset 파일. 가까운 미래에 지원할 계획(참조)
네이티브 코드(예: Android의 Java/Kotlin 또는 iOS의 Objective-C/Swift)
플러터 엔진 (코드 푸시를 사용하여 앱의 플러터 버전을 변경할 수 없습니다)

앱, 릴리즈, 패치, 아티팩트간의 용어 해석

애플리케이션

flutter create [app_name]명령어를 통해 생성되어, 스토어에서 id값을 부여받은 프로젝트를 뜻함

앱은 shorebird init시 부여받은 app_id가 있으며, shorebird.yaml에서 볼 수 있음

앱에는 0개 이상의 릴리즈가 존재

릴리즈

버전과 빌드 번호로 식별되는 특정 버전의 앱 (ex. 1.0.0+1)

릴리즈를 통해 만든 결과물을 스토어에 등록 후 스토어 밖에서 코드 푸시 가능

릴리즈에는 0개 이상의 패치가 존재

패치

특정 릴리즈에 대한 변경 사항

OTA 업데이트로 적용

버그 수정, 새로운 기능 등

릴리즈에 여러 패치를 등록할 수 있지만, 하나의 패치만 활성화할 수 있음

릴리즈 버전과 패치 번호로 식별 (패치 번호는 자동 증가하는 정수)

유저가 앱 실행시, 사용 가능한 패치를 확인하고 백그라운드에서 최신 패치를 적용

이 패치는 다음 앱 시작시 표시됨

아티팩트

빌드 및 패치 작업의 출력

예시)

릴리즈 아티팩트: shorebird release android를 통해 만들어진 여러 아키텍처별 libapp.so 파일과 Android 아카이브(.aab) 파일들
패치 아티팩트: shorebird patch android 를 통해 만들어진 Dart 코드 차이점을 포착하는 diff 파일 등

Cursor, VSCode DebugConsole Filter (or, not 조건)

EEYatHo — Tue, 25 Mar 2025 16:07:53 +0900

개인적으로 로그에 이모지를 사용한다.

그래서 관련된 로그만 보고싶을 때는, 로그창을 필터링하는데,

이렇게 쉽게 할 수 있다.

(network request: )

or 조건

하나라도 포함된 로그로 Filter하고 싶다면 (즉 or조건을 걸고싶다면)

, ️ 이렇게 쉼표를 넣으면 된다

( init: , deinit: ️)

not 조건

해당 값이 없는 로그들로 필터링하고 싶다면,

!를 붙히면 된다

마우스를 올리면 나오는 글이 힌트였는데, 알아듣기 힘들었다..