๋ณธ๋ฌธ ๋ฐ”๋กœ๊ฐ€๊ธฐ
SPA

Svelte 3 -> 4 migration

by NOMADFISH 2023. 10. 1.

Svelte Migration 3 โ†’ 4(1)

Svelete 4

  • Svelte 4 ๋ฒ„์ ผ์ด ์ง€๋‚œ 6์›” ๋ฐœํ‘œ ๋˜์—ˆ์Šต๋‹ˆ๋‹ค. 4๋…„๋งŒ์— ๋ฉ”์ด์ € ์—…๊ทธ๋ ˆ์ด๋“œ๊ฐ€ ์žˆ์—ˆ์Šต๋‹ˆ๋‹ค.
  • 4 ๋ฒ„์ ผ์€ 5๋ฒ„์ ผ์œผ๋กœ ์ง„ํ–‰ํ•˜๊ธฐ ์œ„ํ•œ ์ค‘๊ฐ„ stage๋ผ๊ณ  ์„ค๋ช…ํ•˜๊ณ  ์žˆ์Šต๋‹ˆ๋‹ค.
  • ์ฆ‰ 4๋ฒ„์ ผ์ด ํ›„ 5๋ฒ„์ ผ์€ ์งง์€ ์‹œ๊ฐ„๋‚ด๋กœ ๋ฐœํ‘œ๋  ๊ฒƒ์œผ๋กœ ๋ณด์ž…๋‹ˆ๋‹ค.
    • 4๋ฒ„์ ผ์€ Bridge ๋ฒ„์ ผ์˜ ๋Š๋‚Œ์ด ๊ฐ•ํ•˜๊ณ , ๊ณต์‹ ์‚ฌ์ดํŠธ์—์„œ๋„ Next Generation์€ 5 ๋ฒ„์ ผ์ด๋ผ๋Š” ์„ค๋ช…์ด ๋งŽ์ด ๋‚˜์˜ค๊ณ  ์žˆ์Šต๋‹ˆ๋‹ค.
  • Svelte ๋ฌธ๋ฒ• ์ž์ฒด๊ฐ€ ๋ณ€๊ฒฝ๋œ ๋ถ€๋ถ„์€ ๋งŽ์ด ์—†์ง€๋งŒ, ์ „์ฒด์ ์ธ ํ™˜๊ฒฝ๊ณผ build ๋ฐฉ์‹, route ์‚ฌ์šฉ๋ฒ•๋“ฑ์— ๋Œ€ํ•ด ๋งŽ์€ ๋ถ€๋ถ„ ๋ณ€๊ฒฝ์ด ์žˆ์—ˆ์Šต๋‹ˆ๋‹ค.

์ฃผ์š” ๋ณ€๊ฒฝ ์‚ฌํ•ญ

  • ์ปดํŒŒ์ผ ์ดํ›„ ์ „์ฒด ํŒจํ‚ค์ง€์˜ ํฌ๊ธฐ๊ฐ€ ์•ฝ 12.7% ์ •๋„ ์ค„์–ด๋“ค์—ˆ์Šต๋‹ˆ๋‹ค.
  • Svelte ํŒจํ‚ค์ง€์˜ ํฌ๊ธฐ๊ฐ€ ๊ฑฐ์˜ 75% ๊ฐ์†Œํ•˜์˜€์Šต๋‹ˆ๋‹ค.
  • Svelte ํŒจํ‚ค์ง€์˜ ์ข…์†์„ฑ(Svelte npm์˜ dependency ํŒจํ‚ค์ง€์˜ ์ˆซ์ž)์ˆ˜๊ฐ€ 61โ†’16์œผ๋กœ ๋Œ€ํญ ๊ฐ์†Œํ•˜์˜€์Šต๋‹ˆ๋‹ค.

๊ตฌํ˜„ ๋ณ€๊ฒฝ ์‚ฌํ•ญ

  • Svelte Kit ์ž์ฒด๊ฐ€ ์ƒ์„ฑํ•ด๋‚ด๋Š” Project์˜ ํ˜•ํƒœ๊ฐ€ ๋ณ€๊ฒฝ๋˜์—ˆ์Šต๋‹ˆ๋‹ค.

    • version3: main.js โ†’ App.svelte ๋กœ ์‹œ์ž‘๋˜๋Š” Entry ํ˜•ํƒœ

    • version4: app.html โ†’ (+layout.svelte , +page.svelte) Entry ํ˜•ํƒœ

    • version4 svelte๋Š” version3๋„ ์ž์ฒด๋„ ์ง€์›ํ•˜๊ธฐ ๋•Œ๋ฌธ์— version3 โ†’ version4๋กœ svelte ๋ฒ„์ ผ๋งŒ ์˜ฌ๋ฆฌ๋Š” ํ˜•ํƒœ๋กœ build๊ฐ€ ๊ฐ€๋Šฅ ํ•ฉ๋‹ˆ๋‹ค.

    • https://svelte.dev/docs/v4-migration-guide

      npx svelte-migrate@latest svelte-4
    • ์œ„ command๋กœ ๊ฐ„๋‹จํ•˜๊ฒŒ 3 โ†’ 4๋ฒ„์ ผ์œผ๋กœ migration ๋ฉ๋‹ˆ๋‹ค. ๋‹จ ๋ณ€๊ฒฝ๋œ ์‹ ๊ทœ route ์‹œ์Šคํ…œ๋ฐ vite ๋ฒˆ๋“ค๋Ÿฌ๊ฐ€ ์ ์šฉ๋˜์ง€ ์•Š์œผ๋ฉฐ ๋‹จ์ˆœ์ด svelte version๋งŒ 4๋ฒ„์ ผ์œผ๋กœ ๋ณ€๊ฒฝ ๋ฉ๋‹ˆ๋‹ค.

  • build๋ฅผ ์œ„ํ•ด์„œ ์‚ฌ์šฉ๋˜๋˜ rollup package๊ฐ€ vite๋กœ ๋ณ€๊ฒฝ๋˜์—ˆ์Šต๋‹ˆ๋‹ค.

์ง์ ‘ Migration ํ•˜๊ธฐ1

Migration์„ ์œ„ํ•ด์„œ ์ผ๋‹จ ๊ฐ€์ง• ๊ธฐ๋ณธ svelte 4 code๋ฅผ ์ƒ์„ฑํ•˜๊ณ  ๊ตฌ์กฐ๋ฅผ ๋ถ„์„ํ•ด ๋ด…๋‹ˆ๋‹ค.

  • svelte migration์„ ์ด์šฉํ•˜์—ฌ๋„ ์ข‹์ง€๋งŒ, ์‹ ๊ทœ vite๋ฐ route ์‹œ์Šคํ…œ ๊นŒ์ง€ ๊ฐ™์ด ์ ์šฉ๋œ migration์„ ์ˆ˜๋™์œผ๋กœ ์ง„ํ–‰ ํ•ฉ๋‹ˆ๋‹ค.
  • ๋ฐฉ์‹์€ svelte 3.x ์ฝ”๋“œ๋ฅผ 4.x ์ฝ”๋“œ์™€ ๋น„๊ตํ•˜๋ฉด์„œ ์ฃผ์š” ๊ธฐ๋Šฅ์„ ํ•˜๋‚˜์”ฉ ์˜ฎ๊ฒจ ๋ณด๊ฒ ์Šต๋‹ˆ๋‹ค.
  1. svelte 4.x ์„ค์น˜๋ฐ ์‹ ๊ทœ ์•ฑ ์ƒ์„ฑ

    1. npm create svelte@latest my-app

    2. ๊ฐ€์žฅ ๋จผ์ € ์„ ํƒํ•ด์•ผ ํ•˜๋Š” ๊ฒƒ์€ application์˜ ํ˜•ํƒœ ์ž…๋‹ˆ๋‹ค.

      1. demo app์˜ ์ฝ”๋“œ๊ฐ€ ์ž‘์„ฑ๋˜ ์žˆ๋Š” template๋ฅผ ์‚ฌ์šฉํ•  ๊ฒƒ์ธ๊ฐ€?

      2. skeleton project โ†’ entry ํŽ˜์ด์ง€ ์ฝ”๋“œ๋งŒ ์žˆ๋Š” ๊ฑฐ์˜ ๋น„์–ด ์žˆ๋Š” code๋ฅผ ๋งŒ๋“ค๊ฒƒ์ธ๊ฐ€?

      3. Application์ด ์•„๋‹Œ Library ํ”„๋กœ์ ํŠธ๋ฅผ ์ƒ์„ฑํ•  ๊ฒƒ์ธ๊ฐ€ ์ž…๋‹ˆ๋‹ค.

    3. ์—ฌ๊ธฐ์„œ๋Š” ์ผ๋‹จ demo app ์ฝ”๋“œ ํ•˜๋‚˜๋ฅผ ๋งŒ๋“ค์–ด์„œ migration์‹œ route, component๋“ฑ์— ๋Œ€ํ•œ ๊ตฌํ˜„์„ ์ฐธ์กฐ ํ•˜๊ณ , Skeleton project ์ฝ”๋“œ๋ฅผ ๋งŒ๋“ค์–ด์„œ ์ด Skeleton Project ์ฝ”๋“œ์— 3.x version์œผ๋กœ ์ž‘์„ฑํ•œ ์•ฑ์„ ์˜ฎ๊ฒจ ๋ณด๊ฒ ์Šต๋‹ˆ๋‹ค.

    4. ๋ชจ๋“  ํ”„๋กœ์ ๋Š” Typescript๋กœ ์ง„ํ–‰ ํ•ฉ๋‹ˆ๋‹ค. 4๋ฒ„์ ผ์—์„œ๋Š” 3๋ฒ„์ ผ์— ๋น„ํ•ด์„œ Typescript ์ง€์›์ด ์ข€๋” ๋งค๋„๋Ÿฌ์›Œ ์กŒ๋‹ค๊ณ  ํ•ฉ๋‹ˆ๋‹ค.

    5. ์˜ต์…˜์œผ๋กœ eslint, prettier formation์„ ์„ ํƒ ํ•ฉ๋‹ˆ๋‹ค.

    6. ๋‚˜๋จธ์ง€๋ฅผ ์„ ํƒํ•˜์…”๋„ ๋ฌด๋ฐฉํ•ฉ๋‹ˆ๋‹ค. Playwrite์™€ ๊ฐ™์€ ๊ฒฝ์šฐ๋Š” ๋ธŒ๋ผ์šฐ์ € ํ˜ธํ™˜์„ฑ์„ ์œ„ํ•œ ํ…Œ์ŠคํŠธ ์‚ฌํ•ญ์ž…๋‹ˆ๋‹ค.

      1. https://playwright.dev ์—ฌ๊ธฐ๋ฅผ ์ฐธ์กฐ ํ•˜์„ธ์š”. playwright๋Š” ๋ธŒ๋ผ์šฐ์ € ํ˜ธํ™˜์„ฑ ํ…Œ์ŠคํŠธ๋ฐ ํฌ๋กค๋ง๋“ฑ์„ ์œ„ํ•ด์„œ ์‚ฌ์šฉ๋˜๋Š” ์ผ์ข…์˜ ํˆด์ž…๋‹ˆ๋‹ค.

  1. Demo Project ๋ถ„์„

    1. ์•„๋ž˜์™€ ๊ฐ™์ด ๋ฐ๋ชจ ํ”„๋กœ์ ํŠธ๊ฐ€ ์ƒ์„ฑ ๋ฉ๋‹ˆ๋‹ค.

    2. 3.x ๋ฒ„์ ผ๊ณผ๋Š” ๋งŽ์ด ๋‹ค๋ฅธ folder ๊ตฌ์กฐ๋ฅผ ํ™•์ธ ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

    3. ํŠนํžˆ + ๋กœ ์‹œ์ž‘ํ•˜๋Š” ๋ช‡๊ฐ€์ง€ ์ฝ”๋“œ๋ฅผ ๋ณผ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

    4. Code์— ๋Œ€ํ•œ ์„ค๋ช…

      1. app.html, app.d.ts : svelte์˜ ์‹œ์ž‘ ํŽ˜์ด์ง€์ž…๋‹ˆ๋‹ค. react project๊ฐ€ ์ต์ˆ™ํ•œ ๊ฐœ๋ฐœ์ž๋ผ๋ฉด, publish/index.html์„ ๋ณธ์ ์ด ์žˆ์„ ๊ฒƒ ์ž…๋‹ˆ๋‹ค.

        • react์˜ index.html: react ์‹œ์ž‘์— ํ•„์š”ํ•œ js(๋นŒ๋“œ๋œ js ํŒŒ์ผ), css๋“ฑ์ด ํฌํ•จ๋˜๋Š” ํŒŒ์ผ์ž…๋‹ˆ๋‹ค.

        • ์ด๋ถ€๋ถ„์— react๋กœ ์ž‘์„ฑ๋œ code(๋นŒ๋“œ๋œ js)๋“ค์ด ๋ถ™๊ฑฐ๋‚˜ .js ํŒŒ์ผ link๋กœ ๋ถ™์–ด ๋™์ž‘ํ•˜๊ฒŒ ๋ฉ๋‹ˆ๋‹ค.
          DOCTYPE html>
          <html lang="en">
          <head>
            <meta charset="utf-8" />
            <link rel="shortcut icon" href="%PUBLIC_URL%/favicon.ico" />
            <meta name="viewport" content="initial-scale=1, width=device-width" />
            <meta name="theme-color" content="#000000" />
            <!--
              manifest.json provides metadata used when your web app is installed on a
              user's mobile device or desktop. See https://developers.google.com/web/fundamentals/web-app-manifest/
            -->
            <link href="%PUBLIC_URL%/index.css" rel="stylesheet" />
            <link rel="manifest" href="%PUBLIC_URL%/manifest.json" />
            <!--
              Notice the use of %PUBLIC_URL% in the tags above.
              It will be replaced with the URL of the `public` folder during the build.
              Only files inside the `public` folder can be referenced from the HTML.
          
              Unlike "/favicon.ico" or "favicon.ico", "%PUBLIC_URL%/favicon.ico" will
              work correctly both with client-side routing and a non-root public URL.
              Learn how to configure a non-root public URL by running `npm run build`.
            -->
            <title>MadOwl Youtube Ranking</title>
            <!-- Fonts to support Material Design -->
            <link
              rel="stylesheet"
              href="https://fonts.googleapis.com/css?family=Roboto:300,400,500,700&display=swap"
            />
          </head>
          <body>
            <noscript>You need to enable JavaScript to run this app.</noscript>
            <div id="root"></div>
            <!--
              This HTML file is a template.
              If you open it directly in the browser, you will see an empty page.
          
              You can add webfonts, meta tags, or analytics to this file.
              The build step will place the bundled scripts into the <body> tag.
          
              To begin the development, run `npm start` or `yarn start`.
              To create a production bundle, use `npm run build` or `yarn build`.
            -->
          </body>
          </html>
        • svelte์˜ app.html

        • react์˜ index.html๊ณผ ๋™์ผํ•œ ๋™์ž‘ ์ž…๋‹ˆ๋‹ค. %sveltekit.body% ๋ถ€๋ถ„์ด svelete๋กœ ์ฝ”๋”ฉ๋œ ํŒŒ์ผ๋“ค์ด ๋นŒ๋“œ์™ธ์–ด ๋ถ™๊ฒŒ ๋˜๋Š” ๋ถ€๋ถ„ ์ž…๋‹ˆ๋‹ค.

          <!DOCTYPE html>
          <html lang="en">
            <head>
                <meta charset="utf-8" />
                <link rel="icon" href="%sveltekit.assets%/favicon.png" />
                <meta name="viewport" content="width=device-width" />
                %sveltekit.head%
            </head>
            <body data-sveltekit-preload-data="hover">
                <div style="display: contents">%sveltekit.body%</div>
            </body>
          </html>
      2. route ํด๋”: app ์‹œ์ž‘ํžˆ route ํด๋”์˜ ํด๋” ๊ตฌ์กฐ๊ฐ€ application url route์— ๊ทธ๋Œ€๋กœ ์ ์šฉ๋ฉ๋‹ˆ๋‹ค. ์•„๋ž˜์™€ ๊ฐ™์€ ํด๋”๋ฅผ ๋ณผ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

        • route/+page.svelte
        • route/about/+page.svelte
      3. ์œ„ ํด๋” ๊ตฌ์กฐ๋Š” Application ์‹คํ–‰์‹œ http://{url} โ†’ route/+page.svelte ๊ฐ€ ์‹คํ–‰, http://{url}/about โ†’ route/about/+page.svelte์™€ ๊ฐ™์ด routing ๋ฉ๋‹ˆ๋‹ค.

        1. +layout.svelte, +page.svelte, +page.ts 3๊ฐ€์ง€ ๊ตฌ์„ฑ์„ ๋ณผ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. layout์€ ๋ง๊ทธ๋Œ€๋กœ ํ˜„์žฌ route์˜ layout ์ด๋ฉฐ, header, sidebar ๊ฐ™์€ component์— +page.svelte๋ฅผ body๋กœ ํ‘œํ˜„ํ•  ์ˆ˜ ์žˆ๊ฒŒ ํ•ด์ค๋‹ˆ๋‹ค.

        2. +layout.svelte์€ ํ•˜์œ„ ํด๋” ์ „์ฒด page์—๋„ ๋ชจ๋‘ ํ‘œํ˜„๋ฉ๋‹ˆ๋‹ค. ์ฆ‰ ์œ„์˜ about ํด๋”์—๋Š” layoute์—†์ง€๋งŒ ์ƒ์œ„ layout์˜ ์œ„์— about์ด ํ‘œํ˜„๋˜๊ฒŒ ๋ฉ๋‹ˆ๋‹ค.

        3. +layout.svelte์— slot ๋ถ€๋ถ„์— routing๋˜๋Š” child +page.svelte๋“ค์ด ํ‘œ์‹œ๋ฉ๋‹ˆ๋‹ค.

          <main>
               <slot />
           </main>
      4. +page.ts๋Š” prerender data ์˜์—ญ์ž…๋‹ˆ๋‹ค. ์•„๋ž˜์™€ ๊ฐ™์ด default๋กœ ์ƒ์„ฑ๋˜์–ด ์žˆ์œผ๋ฉฐ ์„ค๋ช…์ด ์“ฐ์—ฌ ์žˆ์Šต๋‹ˆ๋‹ค. โ€œ๋‹ค์ด๋‚˜๋ฏนํ•œ ๋ฐ์ดํ„ฐ๋Š” ์—ฌ๊ธฐ ์—†๋‹ค, ๊ทธ๋ž˜์„œ ์šฐ๋ฆฌ๋Š” ๋จผ์ € ๋žœ๋”๋ง๊ฐ€๋Šฅ ํ•˜๋‹ค. static asset๋“ฑ์„ ์ œ๊ณตํ•  ์ˆ˜ ์žˆ๋‹ค.โ€ ์ž…๋‹ˆ๋‹ค. ํŽ˜์ด์ง€ ๋กœ๋”ฉ์‹œ +page.svelte ๋žœ๋”๋ง ์ „์— ๋จผ์ € ์„ธํŒ…ํ•ด์•ผ ๋˜๋Š” ๋ณ€์ˆ˜๊ฐ’๋“ฑ์„ ๋„ฃ์–ด ๋‘๋Š” ๊ณณ์ž…๋‹ˆ๋‹ค.

         // since there's no dynamic data here, we can prerender
         // it so that it gets served as a static asset in production
         export const prerender = true;
      5. +page.svelte ๊ฐ€ ์‹ค์ œ๋กœ svelte component์ž…๋‹ˆ๋‹ค.

        • +layout.svelte, +page.svelte๋Š” ํ•„์ˆ˜ ํŒŒ์ผ์€ ์•„๋‹™๋‹ˆ๋‹ค. +page.svelte ํŒŒ์ผ์— component๋งŒ ์ •์ƒ์ ์œผ๋กœ ๊ตฌํ˜„๋˜์žˆ๋‹ค๋ฉด, router๋งˆ๋‹ค ์ •์ƒ์ ์œผ๋กœ ํ™”๋ฉด์ด ๋žœ๋”๋ง๋ฉ๋‹ˆ๋‹ค.

      โ†’ ๋‹ค์Œ ํฌ์ŠคํŠธ์—์„œ๋Š” Todo Project๋ฅผ ์ง์ ‘ Migration ํ•ด๋ณด๋Š” ์ž‘์—…์„ ์ง„ํ–‰ํ•ด๋ณด๊ฒ ์Šต๋‹ˆ๋‹ค.

'SPA' ์นดํ…Œ๊ณ ๋ฆฌ์˜ ๋‹ค๋ฅธ ๊ธ€

Svelte Material Todos (2)  (0) 2022.08.31
Svelte Material Todos (1)  (0) 2022.08.23
Svelte Material UI ์ ์šฉํ•˜๊ธฐ  (0) 2022.05.30
Svelte Store  (0) 2021.10.31
Svelte ๊ธ€์ž ๋ฐ”๊พธ๊ธฐ2  (0) 2021.03.24