adapterPath#

상위 메뉴: next.config.js
전체 목차: Next.js 학습 문서

학습 목표#

Next.js의 built-in adapters API가 배포 플랫폼이나 빌드 시스템을 빌드 과정에 연결하는 방식을 이해한다.
adapterPath로 adapter 모듈의 경로를 지정하는 방법을 익힌다.
NEXT_ADAPTER_PATH로 zero-config를 활성화하는 방법과 adapter 관련 후속 문서의 범위를 구분한다.

핵심 개념 및 설명#

Next.js는 built-in adapters API를 제공한다. 배포 플랫폼이나 빌드 시스템을 Next.js 빌드 과정에 통합할 때 이 API를 사용한다. 전체 구현 예시는 `nextjs/adapter-vercel` adapter에서 확인한다.

설정 (Configuration)#

adapter를 사용하려면 adapterPath에 adapter 모듈의 경로를 지정한다.

next.config.jsjs

/** @type {import('next').NextConfig} */
const nextConfig = {
  adapterPath: require.resolve('./my-adapter.js'),
}

module.exports = nextConfig

배포 플랫폼에서는 NEXT_ADAPTER_PATH를 설정해 zero-config로 사용할 수도 있다.

Adapters#

adapter의 전체 구현 방법은 전용 Adapters 문서에서 다룬다.

Adapter 만들기 (Creating an Adapter)#

Creating an Adapter에서 adapter를 만드는 방법을 확인한다.

API Reference#

API Reference에서 adapter API를 확인한다.

Adapter 테스트하기 (Testing Adapters)#

Testing Adapters에서 adapter 테스트 방법을 확인한다.

`@next/routing`을 사용한 라우팅 (Routing with `@next/routing`)#

Routing with `@next/routing`에서 @next/routing을 사용하는 방법을 확인한다.

Adapter에서 PPR 구현하기 (Implementing PPR in an Adapter)#

Implementing PPR in an Adapter에서 adapter에 PPR을 구현하는 방법을 확인한다.

Runtime Integration#

Runtime Integration에서 runtime 통합 방법을 확인한다.

Entrypoint 호출하기 (Invoking Entrypoints)#

Invoking Entrypoints에서 entrypoint를 호출하는 방법을 확인한다.

Output Types#

Output Types에서 output type을 확인한다.

Routing Information#

Routing Information에서 라우팅 정보를 확인한다.

Use Cases#

Use Cases에서 adapter 사용 사례를 확인한다.

예제 및 데모 설계#

데모 가능 여부: 불가
adapter는 배포 플랫폼이나 빌드 시스템을 Next.js 빌드 과정에 연결하는 통합 지점이다. 그래서 일반적인 브라우저 화면만으로는 adapterPath의 효과를 분리해 관찰하기 어렵다.
별도 검증 프로젝트를 만든다면 빌드 파이프라인 실습으로 설계한다. adapterPath와 NEXT_ADAPTER_PATH를 각각 설정해 빌드 과정에서 adapter가 선택되는지 확인하는 방식이다.

연습 문제#

adapterPath의 역할로 올바른 것은 무엇인가?

A. 정적 자산의 공개 URL 접두사를 설정한다.
B. Next.js 빌드 과정에 사용할 adapter 모듈의 경로를 지정한다.
C. 개발 서버가 허용할 Origin 목록을 지정한다.
D. app 디렉터리 사용 여부를 전환한다.

정답 보기

정답: B<br> 해설: adapterPath는 Next.js 빌드 과정에 연결할 adapter 모듈의 경로를 지정한다.

배포 플랫폼에서 adapterPath를 설정 파일에 직접 적지 않고 zero-config로 활성화할 때 사용할 수 있는 환경 변수는 무엇인가?

A. NEXT_ADAPTER_PATH
B. NEXT_RUNTIME_PATH
C. NEXT_BUILD_ADAPTER
D. ADAPTER_PATH_NEXT