OTA(Strings)

SDK를 사용하면 앱이 정기적으로 업데이트된 번역을 확인하고 백그라운드에서 다운로드합니다.

특히 업그레이드를 고려하면 Android SDK의 최신 릴리스를 정기적으로 확인하십시오.

번역을 업데이트하지 않는 경우:

잘못된 버전의 번역을 사용하고 있는 경우 최신 번역과 현재 앱 버전을 사용할 수 있고 앱에 대한 versionName이 설정되어 있는 릴리스가 <주요한 문제>.< 사소한 문제>.<point>. 형식 사용 중인지 확인하십시오.

필수 사항

SDK 포함

루트 build.gradle에 새 리포지토리를 추가합니다.

allprojects {
    repositories {
        ...
        maven { url "https://maven.download.phrase.com" }
    }
}

라이브러리를 종속 상태로 추가:

dependencies {
    implementation "com.phrase.android:ota-sdk:3.5.0"
    ...
}

제트팩 구성 지원

OTA 번역에 대한 Jetpack Compose 지원을 활성화 다음 단계를 수행하십시오.

구성

애플리케이션 클래스에서 SDK를 초기화하고 배포 ID 환경 비밀을 추가. 애플리케이션에서 상속되는 클래스는 활동 컨텍스트 외부의 번역을 활성화하려면 AboutBaseContext 덮어쓰야 합니다.

public class MainApplication extends Application {
  @Override
  public void onCreate() {
      super.onCreate();
      Phrase.setup(this, "DISTRIBUTION_ID", "ENVIRONMENT_TOKEN");
      Phrase.updateTranslations();
  }

  @Override
  protected void attachBaseContext(Context newBase) {
    super.attachBaseContext(Phrase.wrapApplicationContext(newBase));
  }  
}

각 활동에 SDK를 주입합니다. 예를 들어 다른 모든 활동이 상속된 활동을 생성함:

public class BaseActivity extends AppCompatActivity {
  @NonNull
  @Override
  public AppCompatDelegate getDelegate() {
    return Phrase.getDelegate(this, super.getDelegate());
  }
}

다음 레이아웃에서는 평소처럼 번역을 사용할 수 있습니다.

<TextView android:text="@string/translation_key" />

코드 내부:

TextView text = (TextView) findViewById(R.id.text_id);
text.setText(R.string.translation_key);

일부 라이브러리는 컨텍스트 자동 포장 해제를 지원하지 않으며 특정 클래스가 필요합니다. 이러한 경우에는 Jetpack Compose 구성 요소의 컨텍스트 포장 기능을 비활성화할 수 있습니다.

Phrase(contextWrapping = false) {
    Text( text = phraseString(R.string.test) )
}

로그 수준에 대한 구성:

언어 변경

시스템 언어를 사용하지 않는 경우 setLocaleCode 방법에서 다른 언어를 설정할 수 있습니다. 언어 코드(로캘)는 릴리스에 있어야 합니다.

Phrase.setLocaleCode("fr");
Phrase.updateTranslations();

사용자 지정 앱 버전

SDK는 기본적으로 앱 버전을 사용하여 최소 버전과 최대 버전의 릴리스 제한과 일치하는 릴리스를 반환합니다. 앱 버전은 시멘틱 버전 평가를 사용 합니다. 그렇지 않으면 번역 업데이트 반환되지 않습니다. 앱이 시맨틱 버전 설정을 사용 않는 경우 사용한 앱 버전을 수동으로 재정의할 수 있습니다.

예:

Phrase.setAppVersion("3.2.4");

updateTranslations()을 호출하기 전에 버전을 설정해야 합니다.

시간 초과 설정

번역 다운로드의 기본 시간 초과 시간이 10초로 설정됩니다.

기본값을 변경할 수 있습니다:

Phrase.setTimeout(10000); // Timeout in milliseconds

콜백 업데이트

성공적인 번역 업데이트 처리가 필요한 경우 콜백 처리기를 연결합니다.

Phrase.updateTranslations(new TranslationsSyncCallback() {
    @Override
    public void onSuccess(boolean translationsChanged) {
    }

    @Override
    public void onFailure() {
    }
});

번역 업데이트를 수동으로 트리거할 수도 있습니다. 새로 가져온 번역은 다음 응용 프로그램 출시 시 표시됩니다.

최신 번역을 즉시 사용할 수 있도록 방법 Phrase.applyPendingUpdates()를 사용합니다. 번역 업데이트를 위한 청취와 결합할 수 있습니다.

Phrase.updateTranslations(new TranslationsSyncCallback() {
    @Override
    public void onSuccess(boolean translationsChanged) {
      if(translationsChanged) {
         Phrase.applyPendingUpdates()
        // Custom logic to refresh UI
      }
    }

    @Override
    public void onFailure() {
    }
});

UI는 자동으로 번역을 표시하지 않아 다시 생성해야 합니다.

미국 데이터 센터 설정

phrase 미국 데이터 센터 또한 지원됩니다. 미국 데이터 센터 호출하여 구성할 수 있습니다.

Phrase.setHost("https://ota.us.phrase.com/")

번체

클라이언트 네트워크 연결 누락 또는 서비스 중단으로 인해 phrase 연결할 수 없는 경우 SDK는 자원 파일의 번역 번들로 연결됩니다. 앱의 번역 번들 정기적인 업데이트를 권장합니다. SDK는 또한 장치에서 로컬으로 번역을 캐시합니다. 이러한 캐시는 있는 경우 다음 번역 업데이트 때까지 사용됩니다.

SDK는 번역에 가장 최근 릴리스를 사용합니다. 앱의 versionName이 설정된 경우 버전 제한을 충족하는 최신 릴리스가 사용됩니다.

새 언어 추가

phrase 새 언어 생성하고 새 릴리스를 생성. SDK는 사용자 기기 언어 경우 언어 가져옵니다. 새로운 앱 버전을 출시할 때 새로운 언어 파일에 대해 정기적으로 새 strings.xml를 추가하는 것이 좋거나 사용자는 앱을 처음 시작할 때 Android에서 결정한 대체 번역만 볼 수 있습니다.

감사

SDK는 소스 닫혀 있으므로 볼거나 수정할 수 없습니다. 조직 요구 사항이라면 감사를 제공할 수 있습니다. 필요한 경우 자세한 내용을 연락처로 문의하십시오.

사용자 지정 보기 지원

사용자 지정 보기는 스타일별 속성을 사용하여 번역할 수 있습니다. TypedArray 를 사용하면 리소스를 덮어쓸 수 없으므로 사용자 지정 보기에 작은 변경 사항이 필요합니다.

사례 앱

https://github.com/phrase/android-sdk-example

SDK를 사용하면 앱이 정기적으로 업데이트된 번역을 확인하고 백그라운드에서 다운로드합니다.

필수 사항

이 라이브러리는 Flutter의 intl 라이브러리의 0.18.0 버전에 의존합니다. 앱에 현지화 지원을 추가하려면 이들의 가이드를 따르십시오.

설치

pubspec.yaml에 Phrase 추가:

dependencies:
  phrase: ^2.5.1 
  ...
  intl: ^0.18.0
  flutter_localizations:
    sdk: flutter
  ...

flutter:
  generate: true
  ...

intl 라이브러리에서와 마찬가지로 코드 생성은 ARB 파일을 처리하는 데 사용됩니다. 이 명령을 실행하여 업데이트:

flutter pub run phrase

build_runner 사용:

flutter pub run build_runner watch

사용 현황

main.dart 파일에서 Phrase 초기화:

import 'package:flutter/material.dart';
import 'package:flutter_gen/gen_l10n/app_localizations.dart';
import 'package:flutter_gen/gen_l10n/phrase_localizations.dart';
import 'package:phrase/phrase.dart';

void main() {
  Phrase.setup("[DISTRIBUTION_ID]", "[ENVIRONMENT_ID]");
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      제목: 'Flutter 데모',
      //..
      localizationsDelegates: PhraseLocalizations.localizationsDelegates,
      supportedLocales: PhraseLocalizations.supportedLocales,
    );
  }
}

액세스 메시지:

Text(AppLocalizations.of(context)!.helloWorld);

사용자 지정

동작 업데이트

OTA 번역은 앱이 실행될 때마다 업데이트됩니다. 사용 안 함:

Phrase.setup("[DISTRIBUTION_ID]", "[ENVIRONMENT_ID]", 
    checkForUpdates: false);

수동으로 업데이트 다음과 같이 하십시오.

Phrase.updateTranslations(context).then((_) => print("Done!"));

사용자 지정 앱 버전

SDK는 기본적으로 앱 버전을 사용하여 최소 버전과 최대 버전의 릴리스 제한과 일치하는 릴리스를 반환합니다. 앱 버전은 시멘틱 버전 평가를 사용 합니다. 그렇지 않으면 번역 업데이트 반환되지 않습니다. 앱이 의미 체계적 버전 구성을 사용 않는 경우 앱 버전을 수동으로 재정의할 수 있습니다. 앱 버전을 수동으로 재정의할 수 있습니다.

Phrase.setup("[DISTRIBUTION_ID]", "[ENVIRONMENT_ID]",
    customAppVersion: "1.2.3");

미국 데이터 센터 설정

phrase 미국 데이터 센터 또한 지원됩니다. 미국 데이터 센터 SDK 구성에서 관련 API 호스트 이름 매개 변수를 전달하여 선택할 수 있습니다.

Phrase.setup("[DISTRIBUTION_ID]", "[ENVIRONMENT_ID]", host: PhraseHost.us);

사례 앱

https://github.com/phrase/flutter_sdk_example

SDK를 사용하면 앱이 정기적으로 업데이트된 번역을 확인하고 백그라운드에서 다운로드합니다.

Mac Catalyst도 지원됩니다.

SDK는 수동으로 또는 Swift Package Manager, Carthage 또는 Cocoa Pod를 통해 설치할 수 있습니다.

번역을 업데이트하지 않는 경우:

잘못된 번역 버전을 사용하는 경우 최신 번역과 현재 앱 버전을 가진 릴리스가 있는지 확인하십시오.

Swift 패키지 관리자

공개 리포지토리 URL 추가(https: //gitHub.com/phrase/ios-sdk/). Xcode는 나머지 설치를 자동으로 처리합니다.

카르타지

다음 줄을 카트 파일에 추가.

binary "https://raw.githubusercontent.com/phrase/ios-sdk/master/PhraseSDK.json" ~> 3.0.0

카테고리 업데이트를 실행하고 카테고리 문서에 설명된 대로 프로젝트에 PhraseApp.framework을 추가합니다.

코카오 포드

다음 줄을 Podfile에 추가.

pod 'PhraseSDK'

포드 설치 실행 CocoaPods에 새로운 경우 문서를 참조하십시오.

수동 설치

다음 단계를 수행하십시오.

구성

applicationDidFinishLaunchingWithOptions 방법에서 AppDelegate 내에서 두 개의 함수를 호출하는 것이 좋습니다.

대상-C

SDK를 Objective-C 애플리케이션에 통합:

@import PhraseSDK;

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
  [[Phrase shared] setDebugMode:true]; // Optional

  [[Phrase shared] setupWithDistributionID:@"Your Distribution ID"
                         environmentSecret:@"Your Environment Secret"];

  // OR:
  //
  //  [[Phrase shared] setupWithDistributionID:@"Your Distribution ID"
  //                         environmentSecret:@"Your Environment Secret"
  //                                   timeout:10];

  // Update translations using callback block:
  [[Phrase shared] updateTranslationsWithCompletionHandler:^(BOOL updated, NSError* error){
    NSLog(@"Updated: %@", updated ? @"true" : @"false");

    if (error) {
      NSLog(@"Domain: %@ Code: %ld Message: %@", error.domain, (long)error.code, error.localizedDescription);
    } else {
      NSLog(@"No error");
    }

    // Translate via bundle proxy:
    NSString *translation = NSLocalizedString(@"layouts.application.about", @"");
    NSLog(@"NSLocalizedString via bundle proxy: %@", translation);

    // OR:
    //
    // Translate using fallback method:
    NSString *otherTranslation = [[Phrase shared]
                                  localizedStringForKey:@"layouts.application.about" value:NULL table:NULL];
    NSLog(@"Phrase.shared localizedStringForKey: %@", otherTranslation);
  }];

  // OR:
  //
  // [[Phrase shared] updateTranslationsWithCompletionHandler:NULL]; // ignore result and errors (not recommended)

  // [...] Your other code
  
  return YES;
}

사용 안 함 swizzling 사용 안 함

사용 안 함을 사용하려면 Info.plist 파일에서 PhraseSDKMainBundleProxyDisabled를 예로 설정합니다.

swizzling를 비활성화하면 더 이상 업데이트된 번역이 표시되지 않습니다. updateTranslation 를 호출하여 Phrase.localizedString() 방법으로 액세스할 수 있는 경우 번역이 계속 동기화됩니다.

앱 버전 처리

SDK에서 반환해야 하는 릴리스를 결정하려면 번역이 업데이트되기 위해 앱의 의미 버전이 필요합니다.

SDK는 다음과 같이 의미형 버전을 얻으려고 합니다.

CFBundleShortVersionString가 누락되었거나 시멘틱 버전과 함께 생성할 수 없는 경우 CFBundleVersion SDK는 PhraseSetupError.appVersionNotSemantic 메시지를 버립니다.

여러 표에 대해 번역 사용 안 함

기본 Localizable 테이블 이외의 기본 iOS 번들의 테이블을 OTA가 번역하지 못하게 하려면 다음 옵션을 설정합니다.

Phrase.shared.configuration.ignoreOtherTables = true

콜백

성공적인 번역 업데이트를 처리하려면 콜백 처리기를 연결하십시오.

Phrase.shared.updateTranslation { result in
            switch result {
            case .success(let updated):
            case .failure:
            }
        }

Debug 모드

추가 정보가 필요한 경우 Debug 모드를 활성화하여 PhraseSDK.framework을 추가로 콘솔에 로그인하십시오.

Phrase.shared.configuration.debugMode = true

요청에 대한 시간 초과 설정

다음을 호출하여 phrase 대한 요청에 대한 시간 초과를 설정합니다.

Phrase.shared.configuration.timeout = TimeInterval(20)

기본 시간 초과는 10초이며 10초 이상 걸리는 연결은 닫히게 됩니다.

수동 언어 재정의 공유

시스템 언어 로캘 사용하지 않으면 init 호출에서 다른 로캘 설정할 수 있습니다. 로캘 코드는 phrase: 릴리스에 있어야 합니다.

Phrase.shared.configuration.localeOverride = "en-US"

번체

SDK를 통해 phrase 새 번역을 가져올 수 없는 경우 설치가 받은 최신 번역 파일이 사용됩니다. 앱이 phrase 새 파일을 받은 적이 없는 경우 앱의 작성된 번역 파일을 사용합니다. 이를 통해 기술적인 어려움이나 네트워크 오류가 발생할 경우 오류가 예방됩니다. 매 릴리스 시 앱에 compiled된 번역 파일을 최신 상태로 유지하는 것이 좋습니다.

감사

SDK는 소스 닫혀 있으므로 볼거나 수정할 수 없습니다. 조직 요구 사항이라면 감사를 제공할 수 있습니다. 필요한 경우 자세한 내용을 연락처로 문의하십시오.

SDK를 사용하면 앱이 정기적으로 업데이트된 번역을 확인하고 백그라운드에서 다운로드합니다.

OTA 번역 라이브러리가 react-i18next 라이브러리와만 작동합니다.

React Native SDK를 설치하려면 다음 단계를 수행하십시오.

샘플 i18next.js 파일

import i18n from "i18next";
import { initReactI18next } from "react-i18next";
import ChainedBackend from "i18next-chained-backend";
import resourcesToBackend from "i18next-resources-to-backend";
import translationEN from "./locales/en/translation.json";
import translationRU from "./locales/ru/translation.json";
import Phrase from "react-native-phrase-sdk";

const localResources = {
  en: {
    translation: translationEN,
  },
  ru: {
    translation: translationRU,
  },
};

let phrase = new Phrase(
    "YOUR_DISTRIBUTION_ID",
    "YOUR_ENVIRONMENT_ID",
    require('./package.json').version,
    "i18next"
);

const backendPhrase = resourcesToBackend((language, namespace, callback) => {
    phrase.requestTranslation(language)
        .then((remoteResources) => {
            callback(null, remoteResources);
        })
        .catch((error) => {
            callback(error, null);
        });
});

const backendFallback = resourcesToBackend(localResources)

i18n
  .use(ChainedBackend)
  .use(initReactI18next)
  .init({
    backend: {
        backends: [backendPhrase, backendFallback]
    },
    debug: true,
    lng: "en",
    fallbackLng: "en",
    interpolation: {
      escapeValue: false, // not needed for react as it escapes by default
    }
  });

사례 앱

https://github.com/phrase/react_native_sdk_example

i18next-Phrase 백엔드 라이브러리는 i18next의 예시 백엔드를 구현하여 OTA 릴리스에서 번역을 검색합니다.

새 릴리스 생성하려면 i18next 플랫폼을 배포에 설정하고 릴리스의 일부로 설정해야 합니다.

사용 현황

phrase:

import i18n from "i18next";
import { I18nextPhraseBackend } from "@phrase/i18next-backend";

i18n
  .use(I18nextPhraseBackend)
  .init({
    fallbackLng: 'en',
    backend: {
      배포: 'DISTRIBUTION_ID',
      비밀: 'YOUR_ENVIRONMENT_SECRET',
      appVersion: '1.0.0',
    }
  });

캐싱

라이브러리가 번역을 캐싱하고 있으므로 5분 동안 새 번역을 확인하지 않습니다. 테스트 목적으로 백엔드 구성에서 cacheExpirationTime 옵션을 설정하면 캐싱을 구성할 수 있습니다.

i18n
  .use(I18nextPhraseBackend)
  .init({
    fallbackLng: 'en',
    backend: {
      배포: 'DISTRIBUTION_ID',
      비밀: 'YOUR_ENVIRONMENT_SECRET',
      appVersion: '1.0.0',
      cacheExpirationTime: 60 * 5, // 시간(초)
    }
  });

사례 앱

https://github.com/phrase/ota-web-demo

Phrase-OTA-i18n 라이브러리는 I18n 기호의 예시 백엔드를 구현하여 OTA 릴리스의 번역을 검색합니다. 라이브러리와 함께 응용 프로그램은 정기적으로 업데이트된 번역을 확인하고 백그라운드에서 다운로드합니다.

라이브러리는 i18n gem을 사용하는 모든 Ruby 애플리케이션에 유효합니다.

새 릴리스 생성하려면 Rails 플랫폼을 배포에 설정하고 릴리스의 일부로 설정해야 합니다.

설치

사용 현황

구성 생성하려면 다음과 같이 하십시오.

bundle exec rails generate phrase_ota:install --distribution-id <DISTRIBUTION_ID> --secret-token <SECRET>

디버그

보석에는 다음으로 설정하여 초기화기에서 활성화할 수 있는 Debug 구성이 있습니다.

config.debug = true