idev_viewer 1.0.6

IDev-based template viewer plugin for Flutter with 100% identical rendering across all platforms (Android, iOS, Web, Windows)

Changelog

All notable changes to the IDevViewer project will be documented in this file.

1.0.6 - 2025-10-26

🔧 Changed

• base href를 Flutter 패키지 경로로 자동 수정 (/assets/packages/idev_viewer/assets/idev-app/)
• 빌드 스크립트에서 idev-viewer.js 스크립트 태그 자동 추가
• postMessage 핸들러 자동 삽입 개선 (Python 스크립트 사용)
• 배포 스크립트 개선 (사전 체크, 색상 출력, 다단계 검증)

🐛 Fixed

• build-viewer.sh의 perl 정규식 문제 해결
• postMessage 핸들러가 누락되는 문제 수정
• 중복 템플릿 처리 로직 안정화

📚 Documentation

• pub-dev-deployment-guide.md 업데이트
• running-guide.md 업데이트 (포트 번호 통일, 에셋 구조 명확화)
• README.md 업데이트 (워크플로우 간소화)
• 불필요한 스크립트 제거 안내

🗑️ Removed

• sync-idev-core-sources.sh 제거 (사용하지 않음)
• sync-idev-viewer-assets.sh 제거 (pubspec.yaml assets 사용)
• build-idev-viewer-package.sh 제거 (통합 빌드로 대체)

🏗️ Infrastructure

• 통합 빌드 스크립트 (build-viewer.sh)로 모든 작업 자동화
• Flutter 패키지 에셋 시스템 사용 (플랫폼별 에셋 디렉토리 제거)

1.0.0 - 2025-10-26

✨ Added

• 초기 릴리즈
• Flutter Web용 읽기 전용 템플릿 뷰어 구현
• iframe 기반 격리 실행 환경
• PlatformView를 사용한 Web 통합
• 동적 템플릿 업데이트 기능
• Hot Restart 자동 감지 및 재사용
• 커스터마이징 가능한 로딩 화면
• 커스터마이징 가능한 에러 처리
• onReady 콜백 지원

🐛 Fixed

• Hot Restart 시 iframe 중복 생성 문제 해결
• "Container not found" 에러 해결 (PlatformView 등록 타이밍 개선)
• 템플릿 중복 호출 방지 (lastTemplateId 중복 체크)
• window.flutterConfiguration 지원 중단 경고 해결 (engineInitializer 사용)
• 404 에러 해결 (viewer-app assets 등록)
• 초기화 버튼이 재활성화되는 문제 해결
• 뷰어 화면 중첩 문제 해결

🔧 Changed

• dart:ui에서 dart:ui_web로 마이그레이션 (platformViewRegistry)
• idevAppPath를 idev-app으로 사용 (idev-viewer.js 포함)
• Ready 타임아웃을 10초로 증가
• 컨테이너 ID를 고정값(idev-viewer-container-singleton)으로 변경
• 디버깅 로그 제거 (프로덕션 준비)
• viewer-app 제거하고 idev-app 단일 경로로 통합

📚 Documentation

• 상세한 통합 가이드 작성 (VIEWER_INTEGRATION_GUIDE.md)
• README 작성
• 아키텍처 다이어그램 추가
• 트러블슈팅 가이드 추가
• 사용 예제 추가

🏗️ Architecture

• JavaScript 전역 변수를 사용한 Hot Restart 대응
• postMessage 기반 Dart-JavaScript 통신
• 중복 방지 플래그 시스템 구현
• DOM 컨테이너 대기 로직 구현 (50회 재시도, 5초)
• 템플릿 polling 중복 감지 메커니즘

📦 Assets

• idev-app (Flutter 앱 + idev-viewer.js) 포함
• JavaScript 라이브러리 통합 (idev-viewer.js)

---

[Unreleased]

🔮 Planned

• 이벤트 리스너 추가 (onEvent 콜백)
• 설정 옵션 확장 (테마, 로케일)
• 성능 최적화
• TypeScript 타입 정의 추가
• 단위 테스트 추가
• E2E 테스트 추가

---

버전 형식

형식은 Keep a Changelog을 따르며, 버전 관리는 Semantic Versioning을 따릅니다.

버전 규칙

• MAJOR: 호환되지 않는 API 변경
• MINOR: 하위 호환 가능한 기능 추가
• PATCH: 하위 호환 가능한 버그 수정

변경 유형

• Added: 새로운 기능
• Changed: 기존 기능 변경
• Deprecated: 곧 제거될 기능
• Removed: 제거된 기능
• Fixed: 버그 수정
• Security: 보안 관련 변경