OS 2.1から3.0へのプライベートテーマ移行ガイド
現在OS 2.1上で構築されたプライベートテーマを使用しており、OS 3.0へのアップグレードを計画している場合、このガイドでは完全な移行プロセスを案内します。機能比較、構文の変更、アプリの互換性、多言語設定、ストア側が作成したコンテンツ(UGC)データの移行、重要な注意点が含まれています。このバージョンは読みやすさと明確さを最適化しています。
移行のメリット概要
使用タイミング:
これはすでにOS 2.1上でプライベートテーマを開発・公開しており、より統一されたアーキテクチャ、強化された機能、長期的なパフォーマンス向上の恩恵を受けるためにOS 3.0へアップグレードを計画しているマーチャントに適用されます。
| 比較エリア | OS 2.1 プライベートテーマ |
OS 3.0 プライベートテーマ (移行後) |
| システムアーキテクチャ | レガシーシステム、終了間近 | 新しいアーキテクチャで継続的な改善 |
| テンプレート構文 | Handlebars | Sline(高速レンダリング、統一デバッグ) |
| 多言語/マーケット | 柔軟性が限定的 | 主要マーケットと多言語を完全サポート |
| テンプレート管理 | 単一テンプレート対応 | マスターおよびサブテンプレート管理 |
| モジュール構成 | 機能が分散 | 入れ子対応の強力なモジュール構造 |
| レンダリングパフォーマンス | 基本的 | 高速なコンパイルと優れたパフォーマンス |
| アプリ互換性 | カスタムアプリに大きく依存 | より多くのネイティブ機能と統一された統合 |
| 将来の開発 | メンテナンスのみ | コアの革新は3.0に集中 |
構文の違いと移行ガイド
OS 2.1のプライベートテーマからOS 3.0へ移行する際は、Handlebarsテンプレート構文を完全にSlineに変換する必要があります。以下に構文比較を示します:
| 比較項目 | Handlebars(OS 2.1) | Sline(OS 3.0) | |
| データコンテキスト | 手動または一貫性なし | 統一されたデータ構造 | |
| 文字列 | シングルクォート | 複数文字:'str'
|
単一文字のみ使用:'a'
|
| ダブルクォート | 複数文字:"str"
|
複数文字:"str"
|
|
| バックティック | サポートされていません | 複数文字:`str`
|
|
| スコープ | this |
{{ this.title }} |
{{ title }} |
./ |
{{ ./title }} |
{{ title }} |
|
../ |
{{ ../title }} |
親スコープの変数にはアクセスできません | |
| 式 | 配列インデックス | {{ products.[0].title }} |
{{ products[0].title }} |
| 変数アクセス | {{ get key (get index products) }} |
{{ products[index][key] }} |
|
| コメント |
|
{{!-- これはコメントです --}} |
|
| 拡張機能 | Helper |
|
代わりにタグ/フィルターを使用してください |
| タグ | サポートされていません |
|
|
| フィルター | サポートされていません | {{ "a,b,c" | split(",") | join("-") }} |
|
アプリ互換性の概要
使用タイミング:
- 2.1のプライベートテーマにサードパーティ製アプリがインストールされている場合、3.0テーマへの移行前に互換性を確認する必要があります。
推奨される対応:
- すべての有効なアプリをリストアップし、公式の互換性リストと照合してください。
- 公式のアプリ互換性リスト(カスタマーサクセスマネージャーから入手可能)を参照してください。
- OS 3.0でまだサポートされていないアプリについては、組み込みのシステム機能で同等の機能が提供されているか評価するか、アプリ提供者にサポートを問い合わせてください。
- 互換性がなくなったアプリについては、削除するかカスタムの代替品を開発することを検討してください。
|
注意事項:
|
多言語設定の移行
使用タイミング:
2.1テーマに多言語コンテンツがある場合、OS 3.0でもフィールド構造が維持されていることを確認してください。
手順:
- すべてのリッチテキストおよびモジュール設定の翻訳フィールドを確認します。
- 移行支援のためにUGCカスタム多言語翻訳ツールアプリを使用してください。
- 主要市場のデフォルト言語から検証を開始します。
|
注意事項:
|
カスタムデータパーツの移行
使用タイミング:
2.1テーマでカスタムデータパーツを使用している場合、OS 3.0へは手動で移行する必要があります。
手順:
- 移行前に設定ページから各カスタムデータパーツのJSON設定をエクスポートします。
- OS 3.0テーマで対応するパーツ構造を再作成します。
- JSONファイルを新しいカスタムデータパーツにインポートし、テーマに紐付けます。
|
注意事項:
|
リスクと注意事項
- すべてのHandlebarsコードは手動でSline構文に書き換える必要があります。
- 事前にアプリの互換性を確認し、代替案を準備してください。
- 開発者のサポートがあるマーチャントに推奨されます。
- 本番環境に移行する前に、ステージング環境で全プロセスのテストを強く推奨します。
- すべてのカスタムデータパーツデータは手動でエクスポート、再構築、再接続する必要があります。
この記事はAIを使用して翻訳されており、不正確な箇所が含まれている可能性があります。最も正確な情報については、元の英語版をご参照ください。