クイックスタートガイド - Flutter – WOVN.io HelpCenter

WOVN Flutter SDK のインストール方法とクイックガイドです。

WOVN Flutter SDKのインストール

1. Flutter プロジェクトに依存関係を追加する
  - プロジェクト内の pubspec.yaml を編集します。
  - 依存関係の下に、wovn_flutter とローカルバージョンのフォルダーへのパスを追加します。
  - たとえば、./wovnflutter をローカルバージョンへのファイルパスに置き換えます。
2. wovn.yaml 構成ファイルをプロジェクトに追加する
  - アプリケーションプロジェクトのルートに、WOVN プロジェクトトークンと必要なログレベルを含むファイル wovn.yaml を作成します。
  - プロジェクトの pubspec.yaml ファイルの flutter:assets: セクションに、wovn.yaml を追加します。

Data Safety の対応

main() メソッドに以下のプログラムを追記することで、Data Safety の対応を行うことが可能です。
導入いただく企業の中で、Data Safety の対応に関して、お客様の許可を得る必要がある場合もあると思いますので、その場合は、下記プログラムを編集してご利用ください。
```
Wovn().setPermission(DataSafetyPermission.all, true);

Wovn().runAppWithWovn(
　GlobalBlocProviders(
　　 child: PokedexApp(),
　 ),
);
```

SDKの初期化

1. main() メソッドを変更する
  - main.dart ファイル (または main() メソッドを含むファイル) に、次の行を追加します
    - import 'package:wovn_flutter/wovn_flutter.dart'; ファイルの先頭に。
    - main() メソッドで、runApp(...) を Wovn.runAppWithWovn(...) に置き換えます。
  - 前：
  - 後：
2. インストールスクリプトを実行して、アプリケーションの各ウィジェットファイルに WOVN を追加します。
  1. ターミナルで、dart run <path/to/wovnflutter>/scripts/installation.dart <path/to/widget/files> を実行します。
    例： dart run wovnflutter/scripts/installation.dart lib
    1. スクリプトは、アプリ内のすべてのウィジェットファイルに次の変更を自動的に加えます。
      - 前：
      - 後：
3. テキスト以外のウィジェットを翻訳する
  テキストウィジェットに含まれていないが翻訳したい残りのテキスト要素については、これらのウィジェットを WovnListenableBuilder でラップします。
  次に、Wovn().translate(...); で翻訳する必要があるウィジェット内の文字列をラップします。
  - 前：
```
TextField(

  decoration: InputDecoration(

    border: const OutlineInputBorder(),

    hintText: '製品番号を入力してください',

  ),
  ....
);
```
  - 後：
```
WovnListenableBuilder( builder: ((context, child) { 

 return TextField( 

 decoration: InputDecoration( 

 border: const OutlineInputBorder(), 

 hintText: Wovn().translate('製品番号を入力してください', context: context), 

 ), 
....
}),
)
```
4. アプリの言語を変更する

- - - WOVN は、初期設定で端末の言語設定を読み取って自動で言語を切り替えます。
    - 言語切替ウィジェットを作成して、好きな言語を切り替えるには、ユーザーのタップイベントなどで下記コードを実行するようにアプリを実装します
      - Wovn().changeLang(const Locale("en")) - [ご希望の言語を使用する場合]
      - Wovn().changeToSystemLang() - [システム言語を使用する場合]

翻訳の開始

アプリを再起動します
アプリの画面を訪れる

WOVN 管理画面にログインします
値が正常に WOVN 管理画面にレポートされていることを確認します
翻訳がアプリに反映されていることを確認します

このセクションの記事

WOVN Flutter SDKのインストール

Data Safety の対応

SDKの初期化

翻訳の開始

関連記事