Vue Academy · 강의

플러그인 아키텍처와 app.use()

플러그인 객체 { install(app, options) }와 app.component, app.directive, app.provide에 접근하는 방법을 다룹니다.

플러그인 아키텍처와 app.use()은(는) CoddyKit의 무료 Vue Academy 강의입니다. 이것은 4개 중 1번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Vue Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Vue Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

Vue 플러그인이란

Vue 플러그인은 앱 수준의 기능을 추가하는 재사용 가능한 코드입니다. 전역 컴포넌트, 디렉티브, 주입되는 서비스 또는 설정을 추가할 수 있습니다. 예로는 Vue Router, Pinia, i18n 라이브러리가 있습니다.

app.use(plugin)을 사용해 플러그인을 한 번 등록합니다.

install 계약

플러그인은 install(app, options) 메서드를 가진 객체이거나, install로 직접 사용하는 함수입니다. Vue는 앱 인스턴스와 전달한 모든 옵션을 함께 호출합니다.

const myPlugin = {
  install(app, options) {
    // register things on the app here
    console.log('installing with', options)
  }
}

export default myPlugin

전역 컴포넌트 등록하기

install 안에서 app.component(name, definition)을 사용하면 가져오지 않아도 모든 템플릿에서 사용할 수 있는 컴포넌트를 등록할 수 있습니다.

import BaseButton from './BaseButton.vue'
import BaseIcon from './BaseIcon.vue'

const uiKit = {
  install(app) {
    app.component('BaseButton', BaseButton)
    app.component('BaseIcon', BaseIcon)
  }
}

전역 디렉티브 등록하기

app.directive(name, definition)을 사용하면 사용자 지정 디렉티브를 전역으로 등록할 수 있습니다. 예를 들어 v-focus나 v-tooltip을 등록할 수 있습니다.

const focusPlugin = {
  install(app) {
    app.directive('focus', {
      mounted(el) {
        el.focus()
      }
    })
  }
}

// usage in any template: <input v-focus />

주입 가능한 서비스 제공하기

app.provide(key, value)는 모든 자손 컴포넌트가 inject(key)로 읽을 수 있는 값을 노출합니다. 전역 변수 없이 서비스(API 클라이언트, 설정)를 공유하는 현대적인 방법입니다.

const apiPlugin = {
  install(app, options) {
    const client = createClient(options.baseURL)
    app.provide('api', client)
  }
}

제공된 서비스 사용하기

모든 컴포넌트는 inject를 사용해 플러그인이 제공한 값을 읽습니다. 안전성을 위해 타입이 지정된 주입 키(Symbol)를 사용하는 것이 좋지만 문자열 키도 사용할 수 있습니다.

<script setup>
import { inject } from 'vue'

const api = inject('api')
async function load() {
  const data = await api.get('/users')
}
</script>

플러그인에 옵션 전달하기

app.use의 두 번째 인수는 install의 options 매개변수로 전달됩니다. 등록할 때 동작을 설정하는 데 사용합니다.

import { createApp } from 'vue'
import App from './App.vue'
import apiPlugin from './plugins/api'

const app = createApp(App)
app.use(apiPlugin, { baseURL: 'https://api.example.com' })
app.mount('#app')

플러그인은 mount 전에 실행됩니다

모든 app.use 호출은 app.mount 전에 실행됩니다. mount 시점에는 모든 전역 컴포넌트와 디렉티브, 제공된 값이 등록되어 있으므로 첫 번째 렌더링부터 이를 사용할 수 있습니다.

const app = createApp(App)
app.use(router)
app.use(pinia)
app.use(uiKit)
// everything is registered, now render
app.mount('#app')

멱등적 설치

Vue는 하나의 앱에 동일한 플러그인을 두 번 설치하는 것을 방지합니다. 동일한 플러그인에 대한 두 번째 app.use 호출은 무시됩니다. 그래도 install은 안전하게 동작하도록 설계하고 앱 인스턴스 외부에서 부수 효과가 발생하지 않게 해야 합니다.

app.use(myPlugin) // installs
app.use(myPlugin) // ignored, no double registration

완전한 최소 플러그인

지금까지의 내용을 하나로 합치면, 플러그인은 하나의 install 메서드에서 컴포넌트와 디렉티브를 등록하고 서비스를 제공할 수 있습니다.

import Banner from './Banner.vue'

export default {
  install(app, options = {}) {
    app.component('AppBanner', Banner)
    app.directive('focus', { mounted: (el) => el.focus() })
    app.provide('config', { theme: options.theme || 'light' })
  }
}

플러그인과 컴포저블 비교

한 번 실행되는 앱 전체 설정(전역 컴포넌트, 싱글턴 서비스 제공)에는 플러그인을 사용합니다. 컴포넌트별로 사용하는 재사용 가능한 상태 관리 로직에는 컴포저블을 사용합니다. 플러그인은 나중에 컴포저블이 inject로 읽을 내용을 설정하는 경우가 많습니다.

빠른 확인

플러그인 아키텍처에 대한 이해도를 확인해 보세요.

복습

플러그인 아키텍처를 배웠습니다.

플러그인은 install(app, options)을 노출하거나 함수 자체로 사용할 수 있습니다
app.component 및 app.directive는 전역 항목을 등록합니다
app.provide는 inject로 읽을 수 있는 주입 가능한 서비스를 노출합니다
app.use(plugin, options)은 mount 전에 플러그인을 등록합니다
설치는 멱등적이므로 두 번째 설치는 무시됩니다

자주 묻는 질문

“플러그인 아키텍처와 app.use()” 강의는 무료인가요?

네 — “플러그인 아키텍처와 app.use()” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Vue Academy 강의 전체를 잠금 해제할 수 있습니다. Vue Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“플러그인 아키텍처와 app.use()”에서 뭘 배우나요?

플러그인 객체 { install(app, options) }와 app.component, app.directive, app.provide에 접근하는 방법을 다룹니다. 브라우저에서 직접 실행하는 실습 코드로 Vue Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

Vue Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 Vue Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 1번째 강의입니다.

“플러그인 아키텍처와 app.use()” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 Vue Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 Vue Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

← Vue Academy(으)로 돌아가기