shyun_link 2.2.0

Complete deeplink and short URL management with native platform integration. Ultra-simple ShyunLinkManager API, Android/iOS native setup included, Clean Architecture, and enterprise-grade error handling.

ShyunLink

완전한 딥링크 및 단축 URL 관리 패키지 - 네이티브 플랫폼 통합 포함

ShyunLink는 Flutter 앱에서 딥링크와 단축 URL을 쉽게 관리할 수 있는 종합 솔루션입니다. v2.2.0부터 Android/iOS 네이티브 설정 파일이 포함되어 진정한 플러그 앤 플레이 경험을 제공합니다.

✨ v2.2.0 주요 특징

• 🚀 Ultra-Simple API: ShyunLinkManager로 5줄만에 완성!
• 📱 완전한 네이티브 통합: Android/iOS 설정 파일 포함
• 🔧 즉시 사용 가능: Copy-paste로 바로 작동하는 네이티브 설정
• 🧪 테스팅 도구: 네이티브-Flutter 브리지로 딥링크 테스트
• 📚 완전한 가이드: 5분 설정 가이드부터 상세 문서까지
• 🏗️ Clean Architecture: 확장 가능하고 유지보수 용이한 구조
• 🔗 Universal/App Links: iOS Universal Links와 Android App Links 지원

시작하기

설치

pubspec.yaml 파일에 다음 의존성을 추가하세요:

dependencies:
  shyun_link: ^2.2.0
  app_links: ^3.4.3  # 선택사항

🚀 5분 만에 완성하기

1단계: Flutter 초기화 (2분)

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

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  // 🎉 단 5줄로 딥링크 시스템 완성!
  await ShyunLinkManager.initialize(
    appScheme: 'myapp',
    webBaseUrl: 'https://myapp.com',
    onDeepLink: (context) {
      // 딥링크 처리 로직
      Navigator.pushNamed(context, context.route);
    },
  );
  
  runApp(MyApp());
}

2단계: 네이티브 설정 (3분)

⚠️ 중요: 딥링크가 실제로 작동하려면 네이티브 설정이 필요합니다!

• Android: android/app/src/main/AndroidManifest.xml에 intent-filter 추가
• iOS: ios/Runner/Info.plist에 URL scheme 추가

자세한 설정 방법은 플랫폼 설정 가이드를 참고하세요.

📱 즉시 사용하기

짧은 링크 생성

// 스토어 링크 생성
final storeLink = await ShyunLinkManager.createShortLink(
  type: 'store',
  id: 12345,
);

// 큐레이션 링크 생성
final curationLink = await ShyunLinkManager.createShortLink(
  type: 'curation', 
  id: 456,
  metadata: {'type': 'banner'},
);

간편 공유

// 스토어 공유 (링크 생성 + 공유 한번에)
await ShyunLinkManager.shareStore(12345, customText: '맛집 추천!');

// 큐레이션 공유
await ShyunLinkManager.shareCuration(456, 'banner', customText: '확인해보세요!');

// 앱 홍보
await ShyunLinkManager.shareApp(customText: '우리 앱을 다운로드하세요!');

배치 링크 생성

// 여러 링크 한번에 생성
final requests = [
  LinkRequest.store(1),
  LinkRequest.store(2),
  LinkRequest.curation(100, 'banner'),
  LinkRequest.event(50),
];

final links = await ShyunLinkManager.createBatchLinks(requests);
print('생성된 링크: $links');

📱 지원 딥링크 형태

# Custom URL Scheme
myapp://store/12345
myapp://page?type=curation&id=456

# HTTPS Links (Universal/App Links)
https://myapp.com/store/12345
https://myapp.ly/abc123

🧪 딥링크 테스트

# Android (ADB)
adb shell am start -W -a android.intent.action.VIEW -d "myapp://store/12345" com.example.myapp

# iOS (Simulator)
xcrun simctl openurl booted "myapp://store/12345"

📚 완전한 문서

• 간편 사용 가이드 - 5분만에 딥링크 완성!
• 플랫폼 설정 가이드 - Android/iOS 네이티브 설정
• Short Link 가이드 - 상세한 사용법과 예제
• API 레퍼런스 - 완전한 API 문서
• 아키텍처 가이드 - Clean Architecture 구현
• 마이그레이션 가이드 - 버전 업그레이드 가이드

🎯 완전한 예제

example 디렉토리에서 네이티브 통합이 완료된 완전한 예제를 확인할 수 있습니다:

• ✅ Android/iOS 네이티브 설정 완료
• ✅ ShyunLinkManager API 시연
• ✅ 딥링크 테스팅 도구
• ✅ 배치 처리 예제

기여하기

버그 리포트, 기능 제안 등 모든 종류의 기여를 환영합니다. 이슈를 생성하거나 Pull Request를 보내주세요.

라이선스

이 프로젝트는 MIT 라이선스를 따릅니다. 자세한 내용은 LICENSE 파일을 참고하세요.