メインコンテンツまでスキップ

Android SDK v4 インストールガイド

注意: このガイドはWOVN SDK v4.0.0以降に適用されます。それ以前のバージョンについては、サポートにお問い合わせください。

概要​

このガイドでは、AndroidアプリケーションにWOVN SDKを手動でインストールする手順を説明します。インストールは2つの主要なステップで構成されています：

  1. インポートと設定 - WOVN SDKをプロジェクトに追加し、基本設定を行う
  2. ライフサイクルトラッキングの有効化 - SDKがアプリのアクティビティを監視して自動翻訳を行えるようにする

ステップ1：WOVN SDKのインポートと設定​

1.1 必要な権限を追加​

WOVN SDKは翻訳のダウンロードと使用データのレポートにインターネットアクセスが必要です。AndroidManifest.xmlに以下の権限を追加してください：

<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

1.2 WOVN SDKライブラリを追加​

  1. カスタマーサポートから提供されたリンクからWOVN SDKファイル（wovnapp-release.aar）をダウンロード
  2. プロジェクトルートにlibsフォルダがない場合は作成
  3. .aarファイルをlibs/wovnapp-release.aarにコピー
  4. モジュールのbuild.gradleに以下の依存関係を追加：
dependencies {
    implementation files('../libs/wovnapp-release.aar')
}

1.3 設定ファイルを作成​

app/src/main/assetsフォルダに以下の設定でwovn.propertiesファイルを作成します：

token=#{token}                          # WOVNトークンに置き換えてください
loglevel=0                              # 0: 全てのログ; 1: Debug以上; 2: Info以上; 3: Warning以上; 4: Errorのみ; 5: ログなし。デバッグのため初期は0を推奨。
translation_preview_mode=true           # https://wovnio.github.io/WovnAppDocumentation/docs/English/Android/preview_translation

ステップ1の確認​

以下のファイルが変更または作成されているはずです：

ステップ1の確認

アプリを実行し、Logcatを確認します。Wovn: loadDataAndStartWovn:でフィルターすると以下が表示されます：

Wovn: loadDataAndStartWovn: 
    WOVN: Report:Off;ClientID: f147c92d-3d51-442a-871e-6aeb526cc0ea
    Development mode enabled: false
    ClientID: f147c92d-3d51-442a-871e-6aeb526cc0ea
    Helpers.getDeviceLanguages [ko-KP, en-US, ja-JP, vi-VN, it-IT, zh-Hans-CN, zh-Hant-TW]
    Available Languages: [zh-CHS, en-US, vi, ja, it, en-GB, zh-CHT, nl]
    Current Language: en-US

ステップ2：ライフサイクルトラッキングの有効化​

WOVN SDKは自動翻訳を提供するためにアプリのアクティビティを監視する必要があります。Applicationクラス（通常、Applicationクラスを継承したAppまたはApplicationで終わるファイル）にライフサイクルトラッキングを追加します：

final WovnActivityLifecycleCallbacks wovnActivityLifecycleCallbacks = new WovnActivityLifecycleCallbacks();
this.registerActivityLifecycleCallbacks(wovnActivityLifecycleCallbacks);

完全な例：

package io.wovn.app.demo;

import android.app.Application;
import io.wovn.wovnapp.Wovn;
import io.wovn.wovnapp.WovnActivityLifecycleCallbacks;

public class WovnDemoApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();

        // WOVN SDKがアプリのライフサイクルを追跡して自動翻訳を行うために、以下の2行を追加する必要があります
        final WovnActivityLifecycleCallbacks wovnActivityLifecycleCallbacks = new WovnActivityLifecycleCallbacks();
        this.registerActivityLifecycleCallbacks(wovnActivityLifecycleCallbacks);
    }
}

ステップ2の確認​

アプリを実行し、LogcatをWovnActivityLifecycleCallbacksでフィルターします。ライフサイクルイベントが追跡されているのが確認できるはずです：

WovnActivityLifecycleCallbacks: onActivityCreated: activity: io.wovn.app.demo.activities.TextsActivity@eb3c63a
WovnActivityLifecycleCallbacks: onActivityStarted: activity: io.wovn.app.demo.activities.TextsActivity@eb3c63a
WovnActivityLifecycleCallbacks: onActivityStopped: activity: io.wovn.app.demo.activities.MainActivity@faee4a8
WovnActivityLifecycleCallbacks: onActivityStarted: activity: io.wovn.app.demo.activities.MainActivity@faee4a8
WovnActivityLifecycleCallbacks: onActivityStopped: activity: io.wovn.app.demo.activities.TextsActivity@eb3c63a
WovnActivityLifecycleCallbacks: onActivityDestroyed: activity: io.wovn.app.demo.activities.TextsActivity@eb3c63a
WovnActivityLifecycleCallbacks: onActivityCreated: activity: io.wovn.app.demo.activities.WovnIgnoreScreenA@ee4ffb3
WovnActivityLifecycleCallbacks: onActivityStarted: activity: io.wovn.app.demo.activities.WovnIgnoreScreenA@ee4ffb3
WovnActivityLifecycleCallbacks: onActivityStopped: activity: io.wovn.app.demo.activities.MainActivity@faee4a8
WovnActivityLifecycleCallbacks: onActivityStarted: activity: io.wovn.app.demo.activities.MainActivity@faee4a8
WovnActivityLifecycleCallbacks: onActivityStopped: activity: io.wovn.app.demo.activities.WovnIgnoreScreenA@ee4ffb3
WovnActivityLifecycleCallbacks: onActivityDestroyed: activity: io.wovn.app.demo.activities.WovnIgnoreScreenA@ee4ffb3
WovnActivityLifecycleCallbacks: onActivityCreated: activity: io.wovn.app.demo.activities.EditsActivity@9024e02
WovnActivityLifecycleCallbacks: onActivityStarted: activity: io.wovn.app.demo.activities.EditsActivity@9024e02
WovnActivityLifecycleCallbacks: onActivityStopped: activity: io.wovn.app.demo.activities.MainActivity@faee4a8tex

次のステップ​

インストール完了後：

  1. 開発モードの有効化 - デバイスのクライアントIDを登録してレポートと即時翻訳更新を有効にする
  2. アプリをテスト - できるだけ多くの画面を操作する
  3. ダッシュボードを確認 - アプリのアクティビティが翻訳準備完了のページとして表示されるはずです

WOVNダッシュボードのアプリページ