# Instalação

# Nota de compatibilidade

  • Vue.js versões 2.0.0+

# Download direto / CDN

https://unpkg.com/vue-i18n/dist/vue-i18n (opens new window)

O serviço unpkg.com (opens new window) fornece links CDN com base em pacotes NPM. O link acima sempre apontará para a versão mais recente do NPM. Você pode usar uma versão ou tag específica usando um URL como este https://unpkg.com/vue-i18n@8.17.5/dist/vue-i18n.js (opens new window)

Ao conectar o vue-i18n após o Vue, o plug-in será instalado automaticamente:

<script src="https://unpkg.com/vue/dist/vue.js"></script>
<script src="https://unpkg.com/vue-i18n/dist/vue-i18n.js"></script>

# NPM

npm install vue-i18n

# Yarn

yarn add vue-i18n

Ao usar o sistema de módulos, você deve definir explicitamente vue-i18n via Vue.use():

import Vue from 'vue'
import VueI18n from 'vue-i18n'

Vue.use(VueI18n)

Você não precisa fazer isso ao usar tags de script globais <script>.

# Vue CLI 3.x

vue add i18n

O Vue CLI 3.x deve ser instalado previamente, podendo instalá-lo com o próximo comando:

npm install @vue/cli -g

# Dev Build

Se você precisa utilizar a última compilação de dev, precisará clonar o repositório do GitHub e compilar vue-i18n você mesmo.

git clone https://github.com/kazupon/vue-i18n.git node_modules/vue-i18n
cd node_modules/vue-i18n
npm install # ou `yarn`
npm run build  # ou `yarn run build`

# Explicação sobre diferentes versões

Dentro do diretório dist/ do pacote NPM (opens new window) você encontrará muitas compilações diferentes do VueI18n. Aqui está uma visão geral da diferença entre eles:

  • UMD: vue-i18n.js
  • CommonJS: vue-i18n.common.js
  • ES Module para empacotadores: vue-i18n.esm.js
  • ES Module para navegadores: vue-i18n.esm.browser.js

# Termos

  • UMD (opens new window): As compilações UMD podem ser usadas diretamente no navegador através de uma tag <script>. O arquivo padrão do Unpkg CDN em https://unpkg.com/vue-i18n (opens new window) é a versão UMD compilada (vue-i18n.js).

  • CommonJS (opens new window): As compilações do CommonJS são destinadas ao uso com sistemas de compilação mais antigos, como browserify (opens new window) ou webpack 1 (opens new window). O arquivo padrão para esses sistemas de compilação (pkg.main) é a compilação CommonJS (vue-i18n.common.js).

  • ES Module (opens new window): VueI18n desde a versão 8.11 fornece duas compilações de Módulos ES (ESM):

    • ESM para sistemas de compilação: projetado para uso com sistemas de compilação modernos, como webpack 2 (opens new window) ou Rollup (opens new window). O formato ESM é projetado para análise estática para que os sistemas de construção possam realizar uma "agitação de árvore" e remover o código não utilizado no pacote final. O arquivo padrão para esses sistemas de construção (pkg.module) é a construção do Módulo ES somente em tempo de execução (vue-i18n.esm.js).
    • ESM para navegadores (apenas para 8.11+, vue-i18n.esm.browser.js): destinado a importações diretas em navegadores modernos usando a tag <script type="module">.