무선 업데이트 (OTA)는 앱 스토어, 구글 플레이 또는 기타 배포 플랫폼에서 새로운 릴리스를 요구하지 않고 모바일 및 웹 애플리케이션에 번역 업데이트를 제공하는 유연한 방법을 제공합니다. 이 접근 방식은 지연 및 수동 프로세스를 줄여 연속 현지화 및 민첩한 개발 워크플로를 지원합니다.
Phrase Strings의 OTA 기능은 iOS, Android, React Native, Flutter, i18next 및 Rails 플랫폼과 통합됩니다. 텍스트 레이블에 대한 업데이트는 모바일 앱에 즉시 푸시됩니다.
업데이트된 설정이 적용되려면 새로운 릴리스를 생성해야 합니다. 릴리스에 포함된 모든 콘텐츠는 Phrase Strings에서 사용 가능해야 하며, 이는 애플리케이션에 직접 번역을 스트리밍합니다. 콘텐츠가 없으면 번역이 제공되지 않습니다.
모바일 애플리케이션의 경우, OTA는 Phrase Strings에서 런타임에 번역을 검색하기 위해 관련 소프트웨어 개발 키트 (SDK)를 애플리케이션에 통합해야 합니다.
iOS, Android, React Native 또는 Flutter SDK를 처음으로 장치에서 구현할 때, 고유하고 무작위의 장치 식별자가 생성됩니다. 이 식별자는 주어진 기간 동안 활성 사용자를 추적합니다. 다른 형태나 수단의 추적에 사용되지 않으며, 사용자나 장치 정보를 포함하지 않습니다.
OTA 요청 수와 월간 활성 사용자(MAU) 수는 선택한 요금제에 따라 제한됩니다.
MAU는 번역이 요청된 고유 장치의 수입니다. 각 장치에는 무작위 ID가 할당됩니다. MAU는 지난 30일 동안 할당된 고유 ID의 수를 기준으로 계산됩니다. Phrase 서버와의 모든 상호작용은 요청으로 간주됩니다.
OTA 요청으로 전송된 데이터
SDK는 업데이트를 확인하기 위해 OTA 서비스와 통신하며, 각 요청에 다음 세부정보를 포함합니다:
-
장치 식별자 (예: "F3AFCB10-80A2-84CB-94C0-27F5EF58876D". 이 앱에 고유하며 특정 장치를 추적할 수 없습니다.)
-
앱 버전 (예: "1.2.0")
-
번역 파일의 마지막 업데이트 (예: "1542187679")
-
SDK 버전 (예: "1.0.0")
-
로캘 (예: "de-DE")
-
파일 형식 (예: "strings")
-
클라이언트 (예: "ios")
-
배포 ID (배포의 ID)
-
환경 비밀 (개발과 프로덕션을 구분하기 위해)
SDK에서 사용하는 도메인:
EU 데이터 센터
-
ota.eu.phrase.com
-
cdn.eu.phrase.com
-
ota.phraseapp.com
-
cdn.phraseapp.com
US 데이터 센터
-
ota.us.phrase.com
-
cdn.us.phrase.com
Phrase OTA SDK는 OTA API가 사용할 수 없는 경우에도 앱이 기능을 유지하도록 설계되었습니다. 이런 경우, SDK는 장치에 저장된 마지막으로 성공적으로 가져온 번역이나 앱 패키지에 포함된 번역으로 되돌아갑니다. 이것은 최종 사용자에게 오류나 누락된 문자열을 방지합니다. 신뢰할 수 있는 되돌리기를 보장하기 위해, 번들된 번역은 모든 앱 릴리스와 함께 최신 상태로 유지되어야 합니다.
배포는 특정 플랫폼이나 프로젝트에 대해 OTA 업데이트가 어떻게 그리고 어디서 전달되는지를 정의하는 구성된 설정입니다.
대상 플랫폼은 배포 내에서 정의됩니다:
-
iOS
-
Android
-
플러터
-
i18next
-
레일스
여러 배포가 가능하지만 이상적으로는 프로젝트당 하나의 배포가 있습니다. iOS와 Android용 배포를 사용하는 경우 두 형식의 자리 표시자가 자동으로 변환됩니다.
폴백
프로젝트의 언어 설정에 언어 폴백이 설정되어 있는 경우, 요청된 언어가 존재하지만 키가 번역되지 않은 경우 선택된 언어의 문자열이 표시됩니다.
국가별 언어(예: en-GB)가 사용되지만 릴리스의 일부가 아닌 경우, 시스템은 프로젝트에 존재하는 경우 해당 언어의 표준 버전(예: en)으로 폴백할 수 있습니다. 요청된 언어가 전혀 발견되지 않으면 프로젝트의 기본 로캘이 제공될 수 있습니다.
폴백은 링크된 키에서 작동하지 않습니다.
배포 생성
배포를 생성하려면 다음 단계를 따르십시오:
-
페이지의 상자에서 구성 또는 이미 존재하는 구성 수를 클릭합니다.
페이지가 열리고 기존 구성이 표시됩니다.
-
새 배포를 클릭합니다. 창이 열립니다.
-
일반 탭에서 배포와 연결된 , 필수 , 및 필수 을 제공합니다.
-
Android 배포의 경우, 필요한 경우 HTML 태그를 CDATA로 포함하는 형식 옵션을 선택하기 위해 Android 탭을 클릭합니다.
-
배포와 연결할 프로젝트를 선택한 후, 일정 탭이 사용 가능해집니다. 필요한 경우 이 탭을 사용하여 배포에서 OTA 예약 릴리스 설정을 수행합니다.
-
-
대체 언어 탭에서 필요에 따라 배포 특정 대체 설정을 선택합니다. 대체 옵션은 목록에 표시된 대로 우선 순위가 매겨집니다.
-
선택적으로, 번역 탭을 클릭하여 최신 검토된 번역 버전을 사용할 옵션을 선택합니다. 이 옵션은 고급 검토 워크플로로 작업할 때만 활성화합니다.
-
저장을 클릭합니다.
배포 세부정보는 SDK에서 요구하는 ID와 함께 표시됩니다. 세부정보는 페이지에서 배포를 클릭하여 다시 표시할 수 있습니다.
번역을 업데이트하려면 배포 내에서 새 릴리스를 생성합니다. 프로젝트의 현재 상태가 내보내지고 연결된 클라이언트에서 사용할 수 있습니다.
릴리스를 생성하려면 다음 단계를 따르십시오:
-
OTA 페이지에서 필요한 배포 옆에 있는 릴리스 추가를 클릭합니다.
창이 열립니다.
-
, 필수 , , 및 을 제공합니다.
필요한 경우, 릴리스에 특정 태그가 있는 키만 포함하도록 태그를 입력합니다.
-
저장을 클릭합니다.
릴리스는 배포 세부정보 페이지 하단의 목록에 추가됩니다.
배포를 위한 반복 일정을 설정하려면 다음 단계를 따르십시오:
-
페이지에서 필요한 배포 옆에 있는 톱니바퀴
아이콘을 클릭합니다.
창이 표시됩니다.
-
일정 릴리스 탭을 선택하고 를 클릭합니다.
릴리스 일정 옵션이 표시됩니다.
참고
일정 옵션은 새 배포 생성 시에도 사용할 수 있습니다.
-
드롭다운에서 사용 가능한 옵션 중 하나를 선택하여 릴리스 빈도를 선택합니다:
-
-
예정된 릴리스를 위한 원하는 요일을 선택합니다.
-
-
시간과 관련된 를 제공합니다.
-
필요한 경우, 예정된 릴리스를 위해 , 및 를 선택합니다.
-
필드는 프로젝트에서 분기가 활성화된 경우에만 표시됩니다. 분기를 선택하면 로케일 및 언어 목록이 업데이트됩니다.
-
-
선택적으로, 및 필드에 애플리케이션 버전을 지정합니다.
모든 버전의 앱에 일정 릴리스를 적용하려면 비워 두십시오.
-
저장을 클릭합니다.
배포가 릴리스 일정 정보로 업데이트됩니다.
일정을 비활성화하면 배포의 자동 릴리스가 중지되지만, 구성된 설정은 저장됩니다.
적절한 모바일 SDK 또는 웹 라이브러리를 통합하면 단일 클릭으로 번역을 업데이트할 수 있으며, 사용량을 측정할 수 있는 메트릭도 제공합니다. 모바일 SDK와 웹 라이브러리 보고서는 활성 앱 사용자와 그들의 앱 언어에 대한 귀중한 통찰력을 제공합니다. 이 보고서 세트는 각 배포에 대해 제공되며, 데이터는 하루에 두 번 새로 고쳐집니다.
보고서는 활성 사용자 수, 전체 요청 수, 언어별 요청 수, 플랫폼별 요청 수 및 제공되지 않은 장치 언어에 대해 제공됩니다.
각 배포에 대한 보고서는 아이콘을 통해 페이지에서 접근할 수 있습니다.
OTA SDK 통합을 위한 기술 문서는 각 프로젝트 리포지토리의 README 파일에서 확인할 수 있습니다: