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

React Native SDK v2 はじめに

バージョン情報

このガイドは WOVN React Native SDK v2 用です。最新の v4 SDK については、インストールガイド を参照してください。

Wovn React Native SDK は、React Native アプリに多言語対応を簡単に追加できるライブラリです。このガイドでは、Wovn React Native SDK を使い始めるための手順を説明します。

1. SDK のアクセスについてサポートチームに連絡する​

Wovn React Native SDK と Wovn API トークンを取得するには、サポートチームにお問い合わせください。

2. Wovn React Native SDK をインポートする​

Wovn React Native SDK をプロジェクトの依存関係に追加し、依存関係を再インストールします。

"dependencies": {
  // ...
  "@wovnio/react-native": "file:path/to/wovn-react-native.tgz",
  // ...
}

3. Wovn React Native SDK を初期化する​

Wovn.initWovn メソッドは、非同期で SDK を初期化する関数です。Wovn API トークンとオプションの設定オブジェクトの2つの引数が必要です。

注:
他の Wovn SDK メソッドを呼び出す前に、このメソッドを呼び出してください。await を使用することをお勧めします。Wovn.initWovn メソッドについて詳しくは、ドキュメントをご覧ください。

サンプルコード​

import React, { useState, useEffect } from 'react';
import 'expo-router/entry';
import { registerRootComponent } from 'expo';
import { ExpoRoot } from 'expo-router';
import * as Wovn from '@wovnio/react-native';
import { Text, ActivityIndicator, View, StyleSheet } from 'react-native';

async function initializeApp() {
  try {
    await Wovn.initWovn('YOUR_API_TOKEN', {
      enabledDebugLog: true,
      logLevel: 0,
    });
  } catch (error) {
    console.error('Initialization failed:', error);
  }
}

function App() {
  const [isInitialized, setIsInitialized] = useState(false);

  useEffect(() => {
    async function init() {
      await initializeApp();
      setIsInitialized(true);
    }
    init();
  }, []);

  if (!isInitialized) {
    return (
      <View style={styles.centeredView}>
        <ActivityIndicator size="large" color="#0000ff" />
        <Text>LOADING...</Text>
      </View>
    );
  }

  return <ExpoRoot context={require.context('./app')} />;
}

const styles = StyleSheet.create({
  centeredView: {
    flex: 1,
    justifyContent: 'center',
    alignItems: 'center',
  },
});

registerRootComponent(App);

4. 言語管理​

Wovn では、アプリの言語を管理するためのいくつかのメソッドを提供しています。

Wovn.changeToSystemLang() を使用して Wovn に言語設定を管理させることをお勧めします。詳細については Wovn APIs をご覧ください。

サンプルコード​

import * as Wovn from '@wovnio/react-native';

// Wovn を初期化
await Wovn.initWovn('YOUR_API_TOKEN', {
  enabledDebugLog: true,
  logLevel: 0,
});

// システム言語に変更
Wovn.changeToSystemLang();

5. 対応コンポーネントの翻訳​

対応コンポーネントを翻訳するには、react-native ではなく @wovnio/react-native からインポートしてください。

変更前​

import { Button, View, Text, TextInput } from 'react-native';

変更後​

import { View } from 'react-native';
import { Button, Text, TextInput } from '@wovnio/react-native';

6. 非対応コンポーネントの翻訳​

非対応コンポーネントの翻訳に関するガイドは、Translate Unsupported Components を参照してください。

7. Wovn の画面管理について​

Wovn が画面を管理する方法については、Screen Component ドキュメントを参照してください。

8. ユーザープライバシーの保護​

ユーザーのプライバシーを保護する方法については、Protect User Privacy をご覧ください。

9. 追加リソース​

  • 開発時に翻訳の迅速なレポートとリフレッシュを有効にするには、Wovn Debug Mode ドキュメントを参照してください。
  • WOVN React Native v1 SDK から Wovn React Native SDK v2 への移行については、Migration Guide をご覧ください。