์ž‘๊ฐ€:
    ์ƒ์„ฑ:2026-09-23๋งˆ์ง€๋ง‰ ์—…๋ฐ์ดํŠธ:2026-09-23

    Intlayer ํŒจํ‚ค์ง€ ์—…๊ทธ๋ ˆ์ด๋“œ

    bash
    npx intlayer upgrade
    

    upgrade ๋ช…๋ น์–ด๋Š” ๋ชจ๋…ธ๋ ˆํฌ ์›Œํฌ์ŠคํŽ˜์ด์Šค๋ฅผ ํฌํ•จํ•˜์—ฌ ํ”„๋กœ์ ํŠธ์˜ ๋ชจ๋“  package.json์— ์„ ์–ธ๋œ Intlayer ํŒจํ‚ค์ง€๋ฅผ ๋‚˜์—ดํ•˜๊ณ  ์ตœ์‹  ๋ฐฐํฌ ๋ฒ„์ „์œผ๋กœ ์—…๊ทธ๋ ˆ์ด๋“œํ•ฉ๋‹ˆ๋‹ค. intlayer init๊ณผ ๋™์ผํ•œ ํŒจํ‚ค์ง€ ์—…๊ทธ๋ ˆ์ด๋“œ ๋‹จ๊ณ„๋ฅผ ๋…๋ฆฝ์ ์œผ๋กœ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค.

    ์ธ์ˆ˜:

    • --project-root [projectRoot] - ์„ ํƒ ์‚ฌํ•ญ. ํ”„๋กœ์ ํŠธ ๋ฃจํŠธ ๋””๋ ‰ํ„ฐ๋ฆฌ์ž…๋‹ˆ๋‹ค. ๊ธฐ๋ณธ์ ์œผ๋กœ ํ˜„์žฌ ์ž‘์—… ๋””๋ ‰ํ„ฐ๋ฆฌ ์ƒ์œ„์˜ ๊ฐ€์žฅ ๊ฐ€๊นŒ์šด package.json๋ถ€ํ„ฐ ์‹œ์ž‘ํ•ฉ๋‹ˆ๋‹ค.
    • --dry-run - ์„ ํƒ ์‚ฌํ•ญ. ํŒŒ์ผ์„ ์ˆ˜์ •ํ•˜์ง€ ์•Š๊ณ  ํŒจํ‚ค์ง€์™€ ๋Œ€์ƒ ๋ฒ„์ „์„ ๋‚˜์—ดํ•ฉ๋‹ˆ๋‹ค.
    • --tag <tag> - ์„ ํƒ ์‚ฌํ•ญ. ์—…๊ทธ๋ ˆ์ด๋“œํ•  npm dist-tag์ž…๋‹ˆ๋‹ค(์˜ˆ: canary). ๊ธฐ๋ณธ๊ฐ’์€ latest์ž…๋‹ˆ๋‹ค.

    ๋™์ž‘ ๋ฐฉ์‹:

    1. Intlayer ํŒจํ‚ค์ง€ ๋‚˜์—ด - ํ”„๋กœ์ ํŠธ์˜ ๊ฐ package.json(node_modules ๋ฐ ๋นŒ๋“œ ์ถœ๋ ฅ ์ œ์™ธ)์„ ์Šค์บ”ํ•˜์—ฌ intlayer, @intlayer/*, *-intlayer, intlayer-* ์ข…์†์„ฑ ๋ฐ devDependencies๋ฅผ ์ฐพ์Šต๋‹ˆ๋‹ค.
    2. ๋Œ€์ƒ ๋ฒ„์ „ ๊ฐ€์ ธ์˜ค๊ธฐ - npm ๋ ˆ์ง€์ŠคํŠธ๋ฆฌ์—์„œ ๊ฐ ํŒจํ‚ค์ง€์˜ ์„ ํƒ๋œ dist-tag(๊ธฐ๋ณธ๊ฐ’: latest) ๋ฒ„์ „์„ ์ฝ์–ด์˜ต๋‹ˆ๋‹ค.
    3. ๋ฒ„์ „ ๋ฒ”์œ„ ์žฌ์ž‘์„ฑ - ๊ฐ ์˜ค๋ž˜๋œ ๋ฒ”์œ„๋ฅผ ํŒŒ์ผ ๋‚ด์—์„œ ์ง์ ‘ ์—…๋ฐ์ดํŠธํ•˜๋ฉฐ, ์—ฐ์‚ฐ์ž(^, ~ ๋˜๋Š” ์—†์Œ) ๋ฐ ํŒŒ์ผ ๋“ค์—ฌ์“ฐ๊ธฐ๋ฅผ ์œ ์ง€ํ•ฉ๋‹ˆ๋‹ค.
    4. ํ•œ ๋ฒˆ๋งŒ ์„ค์น˜ - ์ž ๊ธˆ ํŒŒ์ผ(lock file)์„ ์†Œ์œ ํ•œ ํŒจํ‚ค์ง€ ๊ด€๋ฆฌ์ž๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ ์›Œํฌ์ŠคํŽ˜์ด์Šค ๋ฃจํŠธ(์ž ๊ธˆ ํŒŒ์ผ์ด ์žˆ๋Š” ๊ฐ€์žฅ ๊ฐ€๊นŒ์šด ๋””๋ ‰ํ„ฐ๋ฆฌ)์—์„œ ๋‹จ์ผ ์„ค์น˜๋ฅผ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค:
    ์ž ๊ธˆ ํŒŒ์ผ๋ช…๋ น์–ด
    bun.lock / bun.lockbbun install
    pnpm-lock.yamlpnpm install
    yarn.lockyarn install
    package-lock.json ๋˜๋Š” ์—†์Œnpm install

    ์ž ๊ธˆ ํŒŒ์ผ์ด ์—†๋Š” ๊ฒฝ์šฐ npm์œผ๋กœ ๋Œ€์ฒดํ•˜๊ธฐ ์ „์— package.json์˜ packageManager ํ•„๋“œ(์˜ˆ: "bun@1.2.0")๊ฐ€ ์‚ฌ์šฉ๋ฉ๋‹ˆ๋‹ค.

    workspace:*, file:, link:, catalog: ๋˜๋Š” git URL๊ณผ ๊ฐ™์ด ๋ ˆ์ง€์ŠคํŠธ๋ฆฌ๋ฅผ ๊ฐ€๋ฆฌํ‚ค์ง€ ์•Š๋Š” ๋ฒ”์œ„๋Š” ์ˆ˜์ •๋˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

    ์˜ˆ์ œ:

    ๋ณ€๊ฒฝ ์‚ฌํ•ญ์„ ์ ์šฉํ•˜์ง€ ์•Š๊ณ  ์‚ฌ์šฉ ๊ฐ€๋Šฅํ•œ ์—…๊ทธ๋ ˆ์ด๋“œ ๋‚˜์—ด:

    bash
    npx intlayer upgrade --dry-run
    

    canary ๋ฆด๋ฆฌ์Šค๋กœ ์—…๊ทธ๋ ˆ์ด๋“œ:

    bash
    npx intlayer upgrade --tag canary
    

    ์ถœ๋ ฅ ์˜ˆ์‹œ:

    bash
    npx intlayer upgrade
    Intlayer packages:
      package.json
        intlayer ^9.0.0 โ†’ ^9.5.7
      apps/web/package.json
        next-intlayer ^9.5.7 (latest)
        vite-intlayer ~9.2.0 โ†’ ~9.5.7
    Running bun install...
    โœ“ Upgraded 2 Intlayer dependencies to latest
    

    ์ฐธ๊ณ :

    • ๋ฆฌํฌ์ง€ํ† ๋ฆฌ ๋ฃจํŠธ์—์„œ ๋ช…๋ น์–ด๋ฅผ ์‹คํ–‰ํ•˜๋ฉด ๋ชจ๋“  ์›Œํฌ์ŠคํŽ˜์ด์Šค๊ฐ€ ์—…๊ทธ๋ ˆ์ด๋“œ๋ฉ๋‹ˆ๋‹ค. ํŠน์ • ์›Œํฌ์ŠคํŽ˜์ด์Šค์—์„œ ์‹คํ–‰ํ•˜๋ฉด ํ•ด๋‹น ์›Œํฌ์ŠคํŽ˜์ด์Šค๋งŒ ์—…๊ทธ๋ ˆ์ด๋“œ๋ฉ๋‹ˆ๋‹ค.
    • ๋ฒ„์ „์„ ๊ฐ€์ ธ์˜ฌ ์ˆ˜ ์—†๋Š” ํŒจํ‚ค์ง€(์˜คํ”„๋ผ์ธ, ๋น„๊ณต๊ฐœ ๋˜๋Š” ๋ฏธ๊ฒŒ์‹œ ํŒจํ‚ค์ง€)๋Š” ๋ชฉ๋ก์— ํ‘œ์‹œ๋˜์ง€๋งŒ ๋ณ€๊ฒฝ๋˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.
    • ์„ค์น˜์— ์‹คํŒจํ•˜๋”๋ผ๋„ ์—…๊ทธ๋ ˆ์ด๋“œ๋œ ๋ฒ”์œ„๋Š” package.json์— ์œ ์ง€๋ฉ๋‹ˆ๋‹ค. ํŒจํ‚ค์ง€ ๊ด€๋ฆฌ์ž์˜ ์„ค์น˜ ๋ช…๋ น์–ด๋ฅผ ์ˆ˜๋™์œผ๋กœ ์‹คํ–‰ํ•˜์„ธ์š”.