๐Ÿš€ ์ฃผ๋‹ˆ์–ดยท์ทจ์ค€์ƒ ๊ฐœ๋ฐœ์ž๋„ ์ดํ•ดํ•˜๋Š” ํ”Œ๋Ÿฌํ„ฐ(Flutter) PWA ๋ฐฐํฌ

๋‹จ์ˆœ ํ† ์ด ํ”„๋กœ์ ํŠธ๋ฅผ ํ…Œ์ŠคํŠธํ•  ๋ชฉ์ ์ด๊ฑฐ๋‚˜, ํšŒ์‚ฌ์—์„œ ๊ฐ„๋‹จํ•˜๊ฒŒ ์‚ฌ์šฉํ•  ์•ฑ์„ ๋งŒ๋“ค๊ธฐ ์œ„ํ•ด ํ”Œ๋Ÿฌํ„ฐ๋กœ ์•ฑ์„ ๊ฐœ๋ฐœํ•œ ํ›„,
์• ํ”Œ ์•ฑ์Šคํ† ์–ด์— ๋ฐฐํฌํ•˜๊ธฐ ์œ„ํ•ด ๋ฐฉ๋ฒ•์„ ์ฐพ์•„๋ดค๋Š”๋ฐ ๊ฐœ๋ฐœ์ž ๋น„์šฉ์ด ๋ฐœ์ƒํ•œ๋‹ค ํ•ด์„œ ๋ฐฉ๋ฒ•์„ ์ฐพ์•„๋ดค๋‹ค.

๋‹จ์ˆœ ํ† ์ด ํ”„๋กœ์ ํŠธ๋ฅผ ํ…Œ์ŠคํŠธํ•  ๋ชฉ์ ์ด๊ฑฐ๋‚˜, ํšŒ์‚ฌ์—์„œ ๊ฐ„๋‹จํ•˜๊ฒŒ ์‚ฌ์šฉํ•  ์•ฑ์„ ๋งŒ๋“ค๊ธฐ ์œ„ํ•ด ํ”Œ๋Ÿฌํ„ฐ๋กœ ์•ฑ์„ ๊ฐœ๋ฐœํ•œ ํ›„,
์• ํ”Œ ์•ฑ์Šคํ† ์–ด์— ๋ฐฐํฌํ•˜๊ธฐ ์œ„ํ•ด ๋ฐฉ๋ฒ•์„ ์ฐพ์•„๋ดค๋Š”๋ฐ ๊ฐœ๋ฐœ์ž ๋น„์šฉ์ด ๋ฐœ์ƒํ•œ๋‹ค ํ•ด์„œ ๋ฐฉ๋ฒ•์„ ์ฐพ์•„๋ดค๋‹ค.

– ํ”Œ๋Ÿฌํ„ฐ๋กœ PWA ๋ฐฐํฌํ•˜๋Š”๊ฒŒ ์ƒ๊ฐ๋ณด๋‹ค ๋‹จ์ˆœํ•˜์—ฌ ๋ฐฐํฌ ๊ณผ์ • ์ค‘ ๊ณค๋ž€ํ•œ ๋ถ„๋“ค๊ป˜ ๊ณต์œ  ์ฐจ ์ž‘์„ฑํ•ฉ๋‹ˆ๋‹ค.

1. ๐Ÿ’ก ์™œ ๋ฐฐํฌํ•˜๋Š”๋ฐ PWA(Progressive Web App)๋ฅผ ์„ ํƒํ–ˆ์„๊นŒ?

์‚ฌ์ด๋“œ ํ”„๋กœ์ ํŠธ๋‚˜ ์‹ค๋ฌด์—์„œ ๋งŒ๋“  ์œ ํ‹ธ๋ฆฌํ‹ฐ ์•ฑ์„ ์‚ฌ์šฉ์ž๋“ค์—๊ฒŒ ๋น ๋ฅด๊ฒŒ ํ”ผ๋“œ๋ฐฑ๋ฐ›๊ณ  ์‹ถ์„ ๋•Œ,

์•ฑ์Šคํ† ์–ด์™€ ํ”Œ๋ ˆ์ด์Šคํ† ์–ด ์‹ฌ์‚ฌ ๊ณผ์ •์€ ๊ฝค๋‚˜ ๋ฒˆ๊ฑฐ๋กญ๊ณ  ์‹œ๊ฐ„์ด ์˜ค๋ž˜ ๊ฑธ๋ฆฐ๋‹ค.

  • PWA์˜ ์žฅ์ : ์›น์œผ๋กœ ๋ฐฐํฌํ•˜์ง€๋งŒ ์Šค๋งˆํŠธํฐ ํ™ˆ ํ™”๋ฉด์— ์•„์ด์ฝ˜์œผ๋กœ ์ถ”๊ฐ€ํ•  ์ˆ˜ ์žˆ๊ณ , ๋„ค์ดํ‹ฐ๋ธŒ ์•ฑ์ฒ˜๋Ÿผ ์ „์ฒด ํ™”๋ฉด์œผ๋กœ ์‹คํ–‰๋œ๋‹ค.
  • ๋ณ„๋„์˜ ์•ฑ์Šคํ† ์–ด ์‹ฌ์‚ฌ ์—†์ด URL๋งŒ ๊ณต์œ ํ•˜๋ฉด ์ฆ‰์‹œ ์—…๋ฐ์ดํŠธ์™€ ๋ฐฐํฌ๊ฐ€ ๊ฐ€๋Šฅํ•˜๋‹ค๋Š” ๊ฒŒ ๊ฐ€์žฅ ํฐ ์žฅ์ ์ด๋‹ค.
  • (โ˜…โ˜…โ˜…) ํ”Œ๋Ÿฌํ„ฐ๋กœ ์•ฑ ๊ฐœ๋ฐœ ํ›„ ์• ํ”Œ์— ๋ฐฐํฌํ•  ์‹œ ๊ฐœ๋ฐœ์ž ๋น„์šฉ(์—ฐ 99๋‹ฌ๋Ÿฌ)๊ฐ€ ๋ฐœ์ƒํ•˜๋Š”๋ฐ, ์ด๋ฅผ ์ ˆ๊ฐํ•  ์ˆ˜ ์žˆ๋‹ค.

2. ๐Ÿ“ฑ ํ”Œ๋žซํผ๋ณ„ ๋งž์ถคํ˜• ๊ณต์œ  ๋ฐ ์ €์žฅ ์ฒ˜๋ฆฌ (kIsWeb)

์›น๊ณผ ๋ชจ๋ฐ”์ผ ํ™˜๊ฒฝ์€ ํŒŒ์ผ ์‹œ์Šคํ…œ์— ์ ‘๊ทผํ•˜๋Š” ๋ฐฉ์‹์ด ๋‹ค๋ฅด๊ธฐ ๋•Œ๋ฌธ์—, ์‹คํ–‰ ์ค‘์ธ ํ™˜๊ฒฝ์— ๋งž์ถฐ ์•ˆ์ „ํ•˜๊ฒŒ ๋ถ„๊ธฐ ์ฒ˜๋ฆฌ๋ฅผ ํ•ด์ฃผ์–ด์•ผ ํ•œ๋‹ค.

  • ์›น(์‚ฌํŒŒ๋ฆฌ/PWA) ํ™˜๊ฒฝ: ๋กœ์ปฌ ๋””๋ ‰ํ† ๋ฆฌ์— ์ ‘๊ทผํ•˜์ง€ ์•Š๊ณ , XFile.fromData๋ฅผ ์ด์šฉํ•ด ๋ฉ”๋ชจ๋ฆฌ ์ƒ์˜ ๋ฐ”์ดํŠธ ๋ฐ์ดํ„ฐ๋ฅผ ๊ฐ์‹ผ ๋’ค ๊ณง๋ฐ”๋กœ ๋ธŒ๋ผ์šฐ์ €์˜ ๊ณต์œ  ์‹œํŠธ(Share Sheet)๋ฅผ ๋„์šฐ๋„๋ก ๊ตฌํ˜„ํ–ˆ๋‹ค.
  • ๋ชจ๋ฐ”์ผ ํ™˜๊ฒฝ: ๊ธฐ์กด์ฒ˜๋Ÿผ ๊ธฐ๊ธฐ์˜ ๋‹ค์šด๋กœ๋“œ ํด๋” ๊ฒฝ๋กœ๋ฅผ ์ƒ์„ฑํ•ด ์•ˆ์ „ํ•˜๊ฒŒ ํŒŒ์ผ์„ ์ €์žฅํ•˜๋„๋ก ํ–ˆ๋‹ค.

Dart

// ์›น ํ™˜๊ฒฝ์ธ์ง€ ๋ชจ๋ฐ”์ผ ํ™˜๊ฒฝ์ธ์ง€ ์ฒดํฌํ•˜์—ฌ ํŒŒ์ผ ์ €์žฅ ๋ฐ ๊ณต์œ  ๋ฐฉ์‹์„ ๋‹ค๋ฅด๊ฒŒ ์ฒ˜๋ฆฌํ•˜๋Š” ๋ถ„๊ธฐ ๋กœ์ง
if (kIsWeb) {
  final XFile xFile = XFile.fromData(
    Uint8List.fromList(pdfBytes),
    name: fileName,
    mimeType: 'application/pdf',
  );

  if (!mounted) return;

  await Share.shareXFiles(
    [xFile],
    text: '์š”์ฒญํ•˜์‹  ํŒŒ์ผ์ž…๋‹ˆ๋‹ค.',
  );
  return;
}

Directory docDir;
if (Platform.isAndroid) {
  docDir = Directory('/storage/emulated/0/Download/My_Folder');
  if (!await docDir.exists()) {
    await docDir.create(recursive: true);
  }
} else {
  final appDocDir = await getApplicationDocumentsDirectory();
  docDir = Directory('${appDocDir.path}/My_Folder');
  if (!await docDir.exists()) {
    await docDir.create(recursive: true);
  }
}

3. ๐Ÿ”ฅ ํŒŒ์ด์–ด๋ฒ ์ด์Šค(Firebase) ๋ฐฐํฌ ํ™˜๊ฒฝ ์„ค์ •

์›ํ™œํ•œ ์›น ํ˜ธ์ŠคํŒ… ๋ฐฐํฌ๋ฅผ ์œ„ํ•ด ํ”„๋กœ์ ํŠธ ๋ฃจํŠธ ๋””๋ ‰ํ† ๋ฆฌ์— ์„ค์ • ํŒŒ์ผ์„ ์ง์ ‘ ๊ตฌ์„ฑํ•˜์—ฌ ๋ฐฐํฌ ๊ธฐ๋ฐ˜์„ ๋‹ค์กŒ๋‹ค.

1) firebase.json ์„ค์ • ํ”„๋กœ์ ํŠธ ๋ฃจํŠธ์— ํŒŒ์ผ์„ ์ƒ์„ฑํ•˜์—ฌ ๋นŒ๋“œ ํด๋”(build/web)์™€ ์‹ฑ๊ธ€ ํŽ˜์ด์ง€ ์•ฑ ๋ผ์šฐํŒ… ๊ทœ์น™์„ ์ง€์ •ํ•œ๋‹ค.

JSON

{
  "hosting": {
    "public": "build/web",
    "ignore": [
      "firebase.json",
      "**/.*",
      "**/node_modules/**"
    ],
    "rewrites": [
      {
        "source": "**",
        "destination": "/index.html"
      }
    ]
  }
}

2) .firebaserc ์„ค์ • ํ”„๋กœ์ ํŠธ ID๋ฅผ ์ง์ ‘ ๋งคํ•‘ํ•˜์—ฌ ํ˜ธ์ŠคํŒ… ๋Œ€์ƒ ํ”„๋กœ์ ํŠธ๋ฅผ 1:1๋กœ ์—ฐ๊ฒฐํ•œ๋‹ค.

JSON

{
  "projects": {
    "default": "๋ณธ์ธ์˜-ํ”„๋กœ์ ํŠธ-ID"
  }
}

4. ๐Ÿš€ ์ตœ์ข… PWA ๋นŒ๋“œ ๋ฐ ๋ฐฐํฌ ํŒŒ์ดํ”„๋ผ์ธ

๋ชจ๋“  ์ค€๋น„๊ฐ€ ๋๋‚ฌ๋‹ค๋ฉด ํ„ฐ๋ฏธ๋„์— ์•„๋ž˜ ์ˆœ์„œ๋Œ€๋กœ ๋ช…๋ น์–ด๋ฅผ ์ž…๋ ฅํ•˜์—ฌ ๊น”๋”ํ•˜๊ฒŒ ๋ฐฐํฌ๋ฅผ ๋งˆ๋ฌด๋ฆฌํ•  ์ˆ˜ ์žˆ๋‹ค.

  • ์ด์ „ ๋นŒ๋“œ ์บ์‹œ ์ฒญ์†Œ

flutter clean

  • ํŒจํ‚ค์ง€ ์˜์กด์„ฑ ์žฌ์„ค์ •

    flutter pub get

    • ์›น์šฉ ์ตœ์ ํ™” ๋นŒ๋“œ ์ˆ˜ํ–‰

    flutter build web --release

    • ํŒŒ์ด์–ด๋ฒ ์ด์Šค ํ˜ธ์ŠคํŒ… ๋ฐฐํฌ

    firebase deploy

    • ๊ฒฐ๊ณผ: ๋ฐฐํฌ๋œ ์ฃผ์†Œ(https://๋‚ดํ”„๋กœ์ ํŠธID.web.app)๋กœ ์•„์ดํฐ ์‚ฌํŒŒ๋ฆฌ์— ๋“ค์–ด๊ฐ€์„œ [ํ™ˆ ํ™”๋ฉด์— ์ถ”๊ฐ€]๋ฅผ ๋ˆ„๋ฅด๋ฉด,
      ์•ฑ์Šคํ† ์–ด๋ฅผ ๊ฑฐ์น˜์ง€ ์•Š๊ณ ๋„ ๋„ค์ดํ‹ฐ๋ธŒ ์•ฑ์ฒ˜๋Ÿผ ์™„๋ฒฝํ•˜๊ฒŒ ๋™์ž‘ํ•˜๋Š” PWA๊ฐ€ ์™„์„ฑ๋œ๋‹ค!
      ์ฃผ๋‹ˆ์–ด ๊ฐœ๋ฐœ์ž๋ผ๋ฉด ์•ฑ ๋ฐฐํฌ ๊ฒฝํ—˜์„ ์Œ“๊ธฐ์— ์ด๋งŒํ•œ ๋ฃจํŠธ๊ฐ€ ์—†๋Š” ๊ฒƒ ๊ฐ™๋‹ค.

    ๋‹ต๊ธ€ ๋‚จ๊ธฐ๊ธฐ