Astro v3로 업그레이드
이 가이드는 Astro v2에서 Astro v3로 마이그레이션하는 데 도움이 됩니다.
이전 프로젝트를 v2로 업그레이드해야 합니까? 이전 마이그레이션 가이드를 참조하세요.
Astro 업그레이드
섹션 제목: Astro 업그레이드패키지 관리자를 사용하여 프로젝트의 Astro 버전을 최신 버전으로 업데이트하세요. Astro 통합을 사용하는 경우 통합과 함께 최신 버전으로 업데이트하세요.
Astro를 최신 버전으로 업그레이드한 후에는 프로젝트를 전혀 변경할 필요가 없을 수도 있습니다!
그러나 오류나 예상치 못한 동작이 발견되면 아래에서 프로젝트 업데이트가 필요할 수 있는 변경 사항을 확인하세요.
Astro v3.0 실험적 플래그 제거
섹션 제목: Astro v3.0 실험적 플래그 제거astro.config.mjs
에서 다음 실험적 플래그를 제거합니다.
이제 다음 기능을 기본적으로 사용할 수 있습니다.
- 페이지 전환 애니메이션 및 지속적 아일랜드에 대한 View Transitions. 이 실험적 플래그를 사용하는 경우 view transitions API 주요 변경 사항 및 업그레이드 조언을 참조하세요.
- 새로운
<Image />
컴포넌트 및getImage()
함수를 포함하는 Astro에서 이미지를 사용하기 위한 새로운 이미지 서비스 API인astro:assets
. 이 실험적 플래그를 사용하고 있는지 여부에 관계없이 자세한 이미지 업그레이드 조언을 읽고 이것이 프로젝트에 어떤 영향을 미칠 수 있는지 확인하세요.
3.0 블로그 게시물에서 이 두 가지 흥미로운 기능에 대해 자세히 알아보세요!
Astro v3.0 주요 변경 사항
섹션 제목: Astro v3.0 주요 변경 사항Astro v3.0에는 몇 가지 주요 변경 사항이 포함되어 있으며 이전에 더 이상 사용되지 않는 일부 기능이 제거되었습니다. v3.0으로 업그레이드한 후 프로젝트가 예상대로 작동하지 않으면 이 가이드에서 모든 주요 변경 사항에 대한 개요와 코드베이스 업데이트 방법에 대한 지침을 확인하세요.
전체 릴리스 노트는 변경 로그를 참조하세요.
제거됨: Node 16에 대한 지원
섹션 제목: 제거됨: Node 16에 대한 지원Node 16은 2023년 9월에 수명이 종료될 예정입니다.
Astro v3.0은 모든 Astro 사용자가 Node의 최신 기능을 활용할 수 있도록 Node 16 지원을 완전히 중단합니다.
어떻게 해야 하나요?
섹션 제목: 어떻게 해야 하나요?개발 환경과 배포 환경 모두 Node 18.14.1
이상을 사용하고 있는지 확인하세요.
-
다음을 사용하여 Node의 로컬 버전을 확인하세요.
-
배포 환경 문서를 확인하여 Node 18을 지원하는지 확인하세요.
대시보드 구성 설정이나
.nvmrc
파일에서 Astro 프로젝트에 대해 Node18.14.1
을 지정할 수 있습니다.
제거됨: TypeScript 4 지원
섹션 제목: 제거됨: TypeScript 4 지원Astro v2.x의 tsconfig.json
프리셋에는 TypeScript 4.x 및 5.x에 대한 지원이 모두 포함됩니다.
Astro v3.0은 TypeScript 5.x만 지원하도록 tsconfig.json
프리셋을 업데이트합니다. Astro는 이제 TypeScript 5.0 (2023년 3월)을 사용하거나 편집기에 TypeScript 5.0이 포함되어 있다고 가정합니다. (예: VS Code 1.77)
어떻게 해야 하나요?
섹션 제목: 어떻게 해야 하나요?TypeScript를 로컬에 설치한 경우 v5.0 이상으로 업데이트하세요.
제거됨: @astrojs/image
섹션 제목: 제거됨: @astrojs/imageAstro v2.x에서는 <Image />
및 <Picture />
컴포넌트를 포함하는 공식 이미지 통합을 제공했습니다.
Astro v3.0은 코드베이스에서 이러한 통합을 완전히 제거합니다. Astro의 새로운 이미지 솔루션은 내장된 이미지 서비스 API인 astro:assets
입니다.
어떻게 해야 하나요?
섹션 제목: 어떻게 해야 하나요?프로젝트에서 @astrojs/image
통합을 제거하세요. 통합을 제거할 뿐만 아니라 import 문과 기존 <Image />
및 <Picture />
컴포넌트도 업데이트하거나 제거해야 합니다. 선호하는 기본 이미지 처리 서비스를 구성해야 할 수도 있습니다.
이미지 가이드에서 이전 이미지 통합을 제거하기 위한 전체 단계별 지침을 확인할 수 있습니다.
astro:assets
로 마이그레이션하면 사용하고 싶은 몇 가지 새로운 이미지 옵션과 기능도 제공됩니다. 자세한 내용은 전체 v3.0 이미지 업그레이드 조언을 참조하세요!
제거됨: <Markdown />
컴포넌트
섹션 제목: 제거됨: <Markdown /> 컴포넌트Astro v1.x는 <Markdown />
컴포넌트를 더 이상 사용하지 않고 외부 패키지로 옮겼습니다.
Astro v3.0은 @astrojs/markdown-component
패키지를 완전히 제거합니다. Astro의 <Markdown />
컴포넌트는 더 이상 프로젝트에서 작동하지 않습니다.
어떻게 해야 하나요?
섹션 제목: 어떻게 해야 하나요?@astrojs/markdown-component
의 모든 인스턴스를 제거합니다.
코드에서 <Markdown />
과 유사한 컴포넌트를 계속 사용하려면 astro-remote
와 같은 커뮤니티 통합 사용을 고려하세요. 통합 자체 문서에 따라 <Markdown />
컴포넌트 가져오기 및 속성을 업데이트하세요.
그렇지 않으면 Astro의 <Markdown />
컴포넌트와 .astro
파일의 컴포넌트 자체 가져오기에 대한 모든 참조를 삭제하세요. 콘텐츠를 HTML로 직접 다시 작성하거나 .md
파일에서 Markdown을 가져와야 합니다.
제거됨: 더 이상 사용되지 않는 1.x API
섹션 제목: 제거됨: 더 이상 사용되지 않는 1.x APIAstro v1.x에서는 <style global>
및 <script hoist>
지원뿐만 아니라 원래 구성 설정을 더 이상 사용하지 않습니다. 그러나 이전 버전과의 호환성을 위해 여전히 지원되었습니다.
Astro v3.0은 더 이상 사용되지 않는 이러한 API를 완전히 제거합니다. 대신 공식적으로 지원되는 구성 설정과 최신 <style is:global>
및 <script>
구문을 사용해야 합니다.
어떻게 해야 하나요?
섹션 제목: 어떻게 해야 하나요?v1.x API를 계속 사용하는 경우 각 기능을 대체하는 새 API를 사용하세요.
- 더 이상 사용되지 않는 구성 옵션: 0.26 마이그레이션 가이드를 참조하세요.
- 더 이상 사용되지 않는 스크립트/스타일 속성 타입: 0.26 마이그레이션 가이드를 참조하세요.
제거됨: 서버 코드의 Web API에 대한 부분 shims
섹션 제목: 제거됨: 서버 코드의 Web API에 대한 부분 shimsAstro v2.x에서는 서버 렌더링 코드에서 document
또는 localStorage
와 같은 Web API에 대한 부분 shims을 제공했습니다. 이러한 shims는 불완전하고 신뢰할 수 없는 경우가 많았습니다.
Astro v3.0은 이러한 부분 shims를 완전히 제거합니다. Web API는 더 이상 서버 렌더링 코드에서 사용할 수 없습니다.
어떻게 해야 하나요?
섹션 제목: 어떻게 해야 하나요?서버 렌더링 컴포넌트에서 Web API를 사용하는 경우 해당 API의 사용을 조건부로 설정하거나 client:only
클라이언트 지시어를 사용해야 합니다.
제거됨: 콘텐츠 컬렉션 스키마 astro:content
의 image
섹션 제목: 제거됨: 콘텐츠 컬렉션 스키마 astro:content의 imageAstro v2.x에서 콘텐츠 컬렉션 API는 콘텐츠 컬렉션 스키마에서 사용하기 위한 astro:content
의 image
내보내기를 더 이상 사용하지 않습니다.
Astro v3.0은 이 내보내기를 완전히 제거합니다.
어떻게 해야 하나요?
섹션 제목: 어떻게 해야 하나요?astro:content
에서 더 이상 사용되지 않는 image()
를 사용하는 경우 더 이상 존재하지 않으므로 제거하세요. 대신 schema
의 image
도우미를 통해 이미지를 확인하세요.
제거됨: 0.14 이전 Shiki 테마 이름
섹션 제목: 제거됨: 0.14 이전 Shiki 테마 이름Astro v2.x에서는 일부 Shiki 테마 이름이 변경되었지만 이전 버전과의 호환성을 위해 원래 이름은 유지되었습니다.
Astro v3.0은 이름이 변경된 테마 이름을 위해 원래 이름을 제거합니다.
어떻게 해야 하나요?
섹션 제목: 어떻게 해야 하나요?프로젝트에서 아래 테마 중 하나를 사용하는 경우 업데이트된 이름으로 이름을 바꾸세요.
material-darker
->material-theme-darker
material-default
->material-theme
material-lighter
->material-theme-lighter
material-ocean
->material-theme-ocean
material-palenight
->material-theme-palenight
제거됨: class:list
기능
섹션 제목: 제거됨: class:list 기능Astro v2.x에서 class:list
지시어는 중복 제거 및 Set
지원과 같은 몇 가지 추가 기능과 함께 clsx
에서 영감을 받은 사용자 정의 구현을 사용했습니다.
Astro v3.0은 이제 class:list
에 clsx
를 직접 사용하며, 중복 제거나 Set
값은 지원하지 않습니다.
어떻게 해야 하나요?
섹션 제목: 어떻게 해야 하나요?class:list
지시어에 전달된 모든 Set
요소를 일반 Array
로 바꾸세요.
제거됨: class:list
를 prop으로 전달
섹션 제목: 제거됨: class:list를 prop으로 전달Astro v2.x에서는 class:list
값이 Astro.props['class:list']
를 통해 컴포넌트로 전송되었습니다.
Astro v3.0은 Astro.props['class']
를 통해 컴포넌트로 전송되기 전에 class:list
값을 문자열로 정규화합니다.
어떻게 해야 하나요?
섹션 제목: 어떻게 해야 하나요?class:list
prop을 받을 것으로 예상되는 코드를 제거하세요.
제거됨: camelCase CSS 변수에 대한 kebab-case 변환
섹션 제목: 제거됨: camelCase CSS 변수에 대한 kebab-case 변환Astro v2.x에서는 style
속성에 전달된 camelCase CSS 변수가 작성된 대로 camelCase 및 하위 호환성을 위한 kebab-case로 렌더링되었습니다.
Astro v3.0은 이러한 camelCase CSS 변수 이름에 대한 kebab-case 변환을 제거하고 원래 camelCase CSS 변수만 렌더링합니다.
어떻게 해야 하나요?
섹션 제목: 어떻게 해야 하나요?Astro를 사용하여 스타일을 kebab-case로 변환했다면 기존 스타일을 camelCase로 업데이트하여 스타일 누락을 방지하세요. 예를 들어:
제거됨: getStaticPaths()
의 반환 값 자동 플랫
섹션 제목: 제거됨: getStaticPaths()의 반환 값 자동 플랫Astro v2.x에서는 getStaticPaths()
의 반환 값이 자동으로 플랫되어 오류 없이 요소가 배열인 배열을 반환할 수 있습니다.
Astro v3.0은 getStaticPaths()
결과의 자동 플랫을 제거합니다.
어떻게 해야 하나요?
섹션 제목: 어떻게 해야 하나요?요소가 객체 인 배열 대신 요소가 배열인 배열을 반환하는 경우 이제 .flatMap
및 .flat
을 사용하여 플랫 배열을 반환해야 합니다.
코드를 업데이트해야 하는 경우 getStaticPaths()
의 반환 값이 객체의 배열이어야 함을 나타내는 오류 메시지가 제공됩니다.
이동됨: astro check
에는 이제 외부 패키지가 필요합니다.
섹션 제목: 이동됨: astro check에는 이제 외부 패키지가 필요합니다.Astro v2.x에서는 astro check
가 기본적으로 Astro에 포함되었으며 해당 종속 항목은 Astro에 번들로 포함되었습니다. 이는 astro check
를 사용했는지 여부에 관계없이 더 큰 패키지를 의미합니다. 이로 인해 사용할 TypeScript 및 Astro 언어 서버 버전을 제어할 수 없게 되었습니다.
Astro v3.0은 astro check
명령을 Astro 코어 밖으로 이동했으며 이제 외부 패키지 @astrojs/check
가 필요합니다. 또한 astro check
명령을 사용하려면 프로젝트에 typescript
를 설치해야 합니다.
어떻게 해야 하나요?
섹션 제목: 어떻게 해야 하나요?Astro v3.0으로 업그레이드한 후 astro check
명령을 실행하고 프롬프트에 따라 필요한 종속성을 설치하거나 프로젝트에 @astrojs/check
및 typescript
를 수동으로 설치하세요.
더 이상 사용되지 않음: build.excludeMiddleware
및 build.split
섹션 제목: 더 이상 사용되지 않음: build.excludeMiddleware 및 build.splitAstro v2.x에서는 build.excludeMiddleware
및 build.split
을 사용하여 SSR 모드에서 어댑터를 사용할 때 특정 파일이 내보내지는 방식을 변경했습니다.
Astro v3.0은 이러한 빌드 구성 옵션을 새로운 SSR 어댑터 구성 옵션으로 대체하여 동일한 작업인 edgeMiddleware
및 functionPerRoute
를 수행합니다.
어떻게 해야 하나요?
섹션 제목: 어떻게 해야 하나요?이제 어댑터 구성의 새 옵션을 직접 사용하려면 Astro 구성 파일을 업데이트하세요.
더 이상 사용되지 않음: markdown.drafts
섹션 제목: 더 이상 사용되지 않음: markdown.draftsAstro v2.x에서는 markdown.drafts
구성을 통해 개발 서버를 실행할 때 사용할 수 있지만 프로덕션에서는 빌드되지 않은 초안 페이지를 가질 수 있었습니다.
Astro v3.0에서는 수동으로 필터링하여 초안 페이지를 처리하는 콘텐츠 컬렉션 방법을 선호하여 이 기능을 더 이상 사용하지 않으며, 이는 기능에 대한 더 많은 제어를 제공합니다.
어떻게 해야 하나요?
섹션 제목: 어떻게 해야 하나요?프로젝트의 일부 페이지를 계속해서 초안으로 표시하려면 콘텐츠 컬렉션으로 마이그레이션하고 대신 draft: true
프런트매터 속성을 사용하여 페이지를 수동으로 필터링하세요.
더 이상 사용되지 않음: 엔드포인트에서 단순 객체 반환
섹션 제목: 더 이상 사용되지 않음: 엔드포인트에서 단순 객체 반환Astro v2.x에서 엔드포인트는 JSON 응답으로 변환되는 간단한 객체를 반환할 수 있습니다.
Astro v3.0에서는 Response
객체를 직접 반환하기 위해 이 동작을 더 이상 사용하지 않습니다.
어떻게 해야 하나요?
섹션 제목: 어떻게 해야 하나요?Response
객체를 직접 반환하도록 엔드포인트를 업데이트하세요.
이전 형식을 유지해야 하는 경우 ResponseWithEncoding
객체를 사용할 수 있지만 앞으로는 더 이상 사용되지 않습니다.
기본값 변경: tsconfig.json 프리셋의 verbatimModuleSyntax
섹션 제목: 기본값 변경: tsconfig.json 프리셋의 verbatimModuleSyntaxAstro v2.x에서 verbatimModuleSyntax
설정은 기본적으로 꺼져 있었고 TypeScript 4.x에 해당하는 importsNotUsedAsValues
는 strict
프리셋에서 활성화되었습니다.
Astro v3.0에서는 verbatimModuleSyntax
가 모든 프리셋에서 활성화됩니다.
어떻게 해야 하나요?
섹션 제목: 어떻게 해야 하나요?이 옵션을 사용하려면 import type
구문을 사용하여 타입을 가져와야 합니다.
위에 표시된 대로 이를 유지하고 type
을 사용하여 타입을 올바르게 가져오는 것이 좋습니다. 문제가 발생하는 경우 tsconfig.json
파일에서 verbatimModuleSyntax: false
를 설정하여 비활성화할 수 있습니다.
기본값 변경: 포트 3000
섹션 제목: 기본값 변경: 포트 3000Astro v2.x에서 Astro는 기본적으로 3000
포트에서 실행되었습니다.
Astro v3.0은 기본 포트를 4321
로 변경합니다. 🚀
어떻게 해야 하나요?
섹션 제목: 어떻게 해야 하나요?예를 들어 테스트나 README
에서 localhost:3000
에 대한 기존 참조를 업데이트하여 새 포트 localhost:4321
을 반영하세요.
기본값 변경: import.meta.env.BASE_URL trailingSlash
섹션 제목: 기본값 변경: import.meta.env.BASE_URL trailingSlashAstro v2.x에서 import.meta.env.BASE_URL
은 기본적으로 base
설정에 trailingSlash를 추가했습니다. trailingSlash: "ignore"
도 후행 슬래시를 추가했습니다.
Astro v3.0은 기본적으로 또는 trailingSlash: "ignore"
가 설정된 경우 더 이상 import.meta.env.BASE_URL
에 후행 슬래시를 추가하지 않습니다. (trailingSlash: "always"
또는 trailingSlash: "never"
와 결합된 base
의 기존 동작은 변경되지 않습니다.)
어떻게 해야 하나요?
섹션 제목: 어떻게 해야 하나요?base
에 이미 후행 슬래시가 있으면 변경할 필요가 없습니다.
base
에 후행 슬래시가 없는 경우 이전 기본값 (또는 trailingSlash: "ignore"
) 동작을 유지하려면 슬래시를 추가하세요.
기본값 변경: compressHTML
섹션 제목: 기본값 변경: compressHTMLAstro v2.x에서 Astro는 compressHTML
이 명시적으로 true
로 설정된 경우에만 방출된 HTML을 압축했습니다. 기본값은 false
였습니다.
Astro v3.0은 이제 기본적으로 방출된 HTML을 압축합니다.
어떻게 해야 하나요?
섹션 제목: 어떻게 해야 하나요?이제 새로운 기본 동작이므로 구성에서 compressHTML: true
를 제거할 수 있습니다.
이제 HTML 압축을 선택 해제하려면 compressHTML: false
를 설정해야 합니다.
변경된 기본값: scopedStyleStrategy
섹션 제목: 변경된 기본값: scopedStyleStrategyAstro v2.x에서 scopedStyleStrategy
의 기본값은 "where"
였습니다.
Astro v3.0에는 "attribute"
라는 새로운 기본값이 도입되었습니다. 기본적으로 스타일은 이제 data-*
속성을 사용하여 적용됩니다.
어떻게 해야 하나요?
섹션 제목: 어떻게 해야 하나요?프로젝트의 현재 스타일 범위 지정을 유지하려면 구성 파일을 이전 기본값으로 업데이트하세요.
기본값 변경: inlineStyleSheets
섹션 제목: 기본값 변경: inlineStyleSheetsAstro v2.x에서는 모든 프로젝트 스타일시트가 기본적으로 링크 태그로 전송되었습니다. "always"
를 사용하여 매번 <style>
태그에 인라인 처리하거나 build.inlineStylesheets
구성의 값을 "auto"
로 설정하여 특정 크기 이하의 스타일시트만 인라인 처리하도록 선택할 수 있습니다. 기본 설정은 "never"
였습니다.
Astro v3.0은 inlineStylesheets
의 기본값을 "auto"
로 변경합니다. ViteConfig.build.assetsInlineLimit
(기본값: 4kb)보다 작은 스타일시트는 기본적으로 인라인입니다. 그렇지 않으면 프로젝트 스타일이 외부 스타일시트로 전송됩니다.
어떻게 해야 하나요?
섹션 제목: 어떻게 해야 하나요?프로젝트의 현재 동작을 유지하려면 build.inlineStylesheets
를 이전 기본값인 "never"
로 설정하세요.
변경된 기본값: 이미지 서비스
섹션 제목: 변경된 기본값: 이미지 서비스Astro v2.x에서는 Squoosh가 기본 이미지 처리 서비스였습니다.
Astro v3.0에서는 이제 Sharp가 기본 이미지 처리 서비스로 포함되어 있으며 대신 Squoosh를 사용하기 위한 구성 옵션이 제공됩니다.
어떻게 해야 하나요?
섹션 제목: 어떻게 해야 하나요?pnpm
과 같은 엄격한 패키지 관리자를 사용하는 경우 Astro 종속성이기는 하지만 프로젝트에 직접 Sharp를 설치해야 할 수 있습니다:
Squoosh를 계속 사용하여 이미지를 변환하려면 다음과 같이 구성을 업데이트하세요.
변경됨: HTTP 요청 메서드
섹션 제목: 변경됨: HTTP 요청 메서드Astro v2.x에서는 HTTP 요청 메서드가 소문자 함수 이름 (get
, post
, put
, all
및 del
)을 사용하여 작성되었습니다.
Astro v3.0은 del
대신 DELETE
를 포함한 대문자 함수 이름을 사용합니다.
어떻게 해야 하나요?
섹션 제목: 어떻게 해야 하나요?모든 함수의 이름을 해당하는 대문자로 바꿉니다.
get
을GET
로 변경합니다.post
를POST
로 변경합니다.put
을PUT
로 변경합니다.all
을ALL
로 변경합니다.del
을DELETE
로 변경합니다.
변경됨: 다중 JSX 프레임워크 구성
섹션 제목: 변경됨: 다중 JSX 프레임워크 구성Astro v2.x에서는 어떤 파일이 어떤 프레임워크를 사용하는지 식별할 필요 없이 동일한 프로젝트에서 여러 JSX 프레임워크 통합 (React, Solid, Preact)을 사용할 수 있습니다.
Astro v3.0에서는 이제 여러 JSX 프레임워크 통합이 설치된 경우 새로운 include
및 exclude
통합 구성 옵션을 사용하여 파일에 사용할 프레임워크를 지정해야 합니다. 이를 통해 Astro는 단일 프레임워크 사용은 물론 React Fast Refresh와 같은 고급 기능을 더 잘 지원할 수 있습니다.
어떻게 해야 하나요?
섹션 제목: 어떻게 해야 하나요?동일한 프로젝트에서 여러 JSX 프레임워크를 사용하는 경우 include
(및 선택적으로 exclude
)를 파일 및/또는 폴더 배열로 설정하세요. 와일드카드를 사용하여 여러 파일 경로를 포함할 수 있습니다.
포함을 더 쉽게 지정할 수 있도록 공통 프레임워크 컴포넌트를 동일한 폴더 (예: /components/react/
및 /components/solid/
)에 배치하는 것이 좋지만 필수는 아닙니다.
변경됨: Astro.cookies.get(key)
는 undefined
를 반환할 수 있습니다.
섹션 제목: 변경됨: Astro.cookies.get(key)는 undefined를 반환할 수 있습니다.Astro v2.x에서 Astro.cookies.get(key)
는 쿠키가 존재하지 않더라도 항상 AstroCookie
객체를 반환합니다. 존재 여부를 확인하려면 Astro.cookies.has(key)
를 사용해야 했습니다.
Astro v3.0은 쿠키가 존재하지 않는 경우 Astro.cookies.get(key)
가 undefined
을 반환합니다.
어떻게 해야 하나요?
섹션 제목: 어떻게 해야 하나요?이 변경 사항은 Astro.cookies.get(key)
를 사용하기 전에 Astro.cookie
객체의 존재를 확인하는 코드를 손상시키지 않지만 이제는 더 이상 필요하지 않습니다.
Astro.cookies
값이 undefined
인지 확인하기 위해 has()
를 사용하는 모든 코드를 안전하게 제거할 수 있습니다.
변경됨: Astro CLI를 프로그래밍 방식으로 실행
섹션 제목: 변경됨: Astro CLI를 프로그래밍 방식으로 실행Astro v2.x에서는 "astro"
패키지 엔트리포인트가 Astro CLI를 직접 내보내고 실행했습니다. 실제로 Astro를 이런 방식으로 실행하는 것은 권장되지 않습니다.
Astro v3.0은 엔트리포인트에서 CLI를 제거하고 dev()
, build()
, preview()
및 sync()
를 포함한 새로운 실험적 JavaScript API 세트를 내보냅니다.
어떻게 해야 하나요?
섹션 제목: 어떻게 해야 하나요?Astro CLI를 프로그래밍 방식으로 실행하려면 새로운 실험적 JavaScript API를 사용하세요.
변경됨: 인터널 Astro API 엔트리포인트 내보내기 경로
섹션 제목: 변경됨: 인터널 Astro API 엔트리포인트 내보내기 경로Astro v2.x에서는 astro/internal/*
및 astro/runtime/server/*
에서 인터널 Astro API를 가져올 수 있습니다.
Astro v3.0은 기존 astro/runtime/*
엔트리포인트를 위해 두 엔트리포인트를 제거합니다. 또한 컴파일러별 런타임 코드를 위한 새로운 astro/compiler-runtime
내보내기가 추가되었습니다.
어떻게 해야 하나요?
섹션 제목: 어떻게 해야 하나요?이는 Astro의 인터널 API에 대한 엔트리포인트이며 프로젝트에 영향을 주지 않아야 합니다. 그러나 이러한 엔트리포인트를 사용하는 경우 아래와 같이 업데이트하세요.
커뮤니티 자료
섹션 제목: 커뮤니티 자료Astro v3.0에 대한 좋은 자료를 알고 계십니까? 이 페이지를 편집하여 아래 링크를 추가하세요!
알려진 문제
섹션 제목: 알려진 문제현재 알려진 문제는 없습니다.
Upgrade Guides