Buscar pacotes, repositórios e categorias de apps

Detalhes do pacotev1.6.0

yaml_localizations

Um pacote de localização minimalista em YAML baseado no LocalizationsDelegate.

AndroidiOSWebmacOSWindowsLinux
Downloads em 30 dias
33
Curtidas
2
Pontos Pub
150

Instalar pacote

flutter pub add yaml_localizations

Visão geral do pacote

Orientação gerada a partir de informações públicas. Apenas para referência.

Um pacote leve do Flutter para gerenciar traduções de aplicativos usando arquivos YAML, construído sobre o LocalizationsDelegate do Flutter. Permite internacionalização fácil ao carregar strings localizadas a partir de recursos YAML, simplificando o processo de suporte a múltiplos idiomas sem configuração complexa. O pacote se integra perfeitamente em aplicativos Flutter em todas as principais plataformas, oferecendo uma maneira limpa e sustentável de lidar com localização com mínimo boilerplate. Ideal para desenvolvedores que buscam uma alternativa simples a sistemas de tradução baseados em JSON ou codificados diretamente.

Casos de uso

  • Suporte a aplicativos multilíngues
  • Gerenciamento simples de tradução
  • Integração com projetos Flutter existentes
  • Solução leve de localização
  • Mudança dinâmica de idioma

Principais recursos

  • arquivos de tradução baseados em YAML
  • Construído no LocalizationsDelegate
  • Compatibilidade multiplataforma
  • Configuração mínima
  • Fácil de estender e manter

Indicado para

  • Aplicativos pequenos a médios
  • Desenvolvedores que preferem YAML em vez de JSON
  • Projetos que precisam de configuração rápida de i18n
  • Equipes evitando estruturas complexas de localização
  • Aplicativos direcionados para múltiplas plataformas

Considerações

  • Requer gerenciamento manual de arquivos YAML
  • Nenhum ferramenta de edição de tradução integrada
  • Limitado a traduções baseadas em strings
  • Não ideal para fluxos de trabalho de tradução em grande escala
  • Nenhuma atualização de tradução em tempo de execução

README original

Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.

yaml_localizations

A minimal YAML localization package for Flutter.

YAML is a human-readable, configuration file format with a minimal syntax, which allows you to represent strings as key/value pairs in addition to other types.

YAML is the format used by Flutter's pubspec.yaml file.

Install

Add yaml_localizations and flutter_localizations as dependencies to your pubspec.yaml.

dependencies:
  flutter_localizations:
    sdk: flutter
  yaml_localizations:
Add a YAML file per language

Add a YAML file per language you support in an asset path and describe it in your pubspec.yaml

flutter:
  assets:
    - assets/yaml_translations/

The YAML file name must match the language tag described in supportedLocales.

E.g. Locale('en', 'US') must have a corresponding assetPath/en-US.yaml file.

Add localizationDelegates and supportedLocales

Add YamlLocalizationsDelegate to MaterialApp and set supportedLocales using language/country codes.

MaterialApp(
  localizationsDelegates: [
    // global delegates
    ...GlobalMaterialLocalizations.delegates,
    // yaml localizations
    YamlLocalizationsDelegate(path: 'assets/yaml_translations'),
  ],
  supportedLocales: [
    Locale('en', 'GB'),
    Locale('en', 'US'),
    Locale('en'),
    Locale('nb'),
  ],
}

Note on iOS

Add supported languages to ios/Runner/Info.plist as described here.

Example:

<key>CFBundleLocalizations</key>
<array>
	<string>en-GB</string>
	<string>en</string>
	<string>nb</string>
</array>

YAML format

Hi: Hi
Text: |
  There once was a tall man from Ealing
  Who got on a bus to Darjeeling
      It said on the door
      "Please don't sit on the floor"
  So he carefully sat on the ceiling
Long: >
  Wrapped text
  will be folded
  into a single
  paragraph

  Blank lines denote
  paragraph breaks

Tip: Yaml supports several ways of expressing strings. Use the vertical bar character to indicate that a string will span several lines. Use the greater-than character to break up long lines.

API

Translate strings using

YamlLocalizations.of(context)?.string('Hi')

We keep the API simple, but you can easily add an extension method to String like this:

extension LocalizedString on String {
  String tr(BuildContext context) => YamlLocalizations.of(context)!.string(this);
}

So you can use it like this:

'Hi'.tr(context)

Example

See example

Categorias

Dependências

Lista de dependências 1 itens

Repositório-fonte

Projetos que usam este pacote

Ainda não há dados.