Merge pull request #45 from Live2D/develop

Cubism 4 SDK for Web R5

CHANGELOG.md

@@ -5,6 +5,13 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
 
+## [4-r.5] - 2022-09-08
+
+### Added
+
+* Add the multilingual supported documents.
+
+
 ## [4-r.5-beta.5] - 2022-08-04
 
 ### Changed
@@ -146,6 +153,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 * Fix issue with reloading model images in WebKit.
 
 
+[4-r.5]: https://github.com/Live2D/CubismWebSamples/compare/4-r.5-beta.5...4-r.5
 [4-r.5-beta.5]: https://github.com/Live2D/CubismWebSamples/compare/4-r.5-beta.4...4-r.5-beta.5
 [4-r.5-beta.4]: https://github.com/Live2D/CubismWebSamples/compare/4-r.5-beta.3...4-r.5-beta.4
 [4-r.5-beta.3]: https://github.com/Live2D/CubismWebSamples/compare/4-r.5-beta.2...4-r.5-beta.3

Core/CHANGELOG.md

@@ -5,6 +5,14 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
 
+## 2022-09-08
+
+### Added
+
+* Add the multilingual supported documents.
+* Support Visual Studio 2022.
+
+
 ## 2022-08-04
 
 ### Fixed

Core/README.ja.md

@@ -0,0 +1,30 @@
+[English](README.md) / [日本語](README.ja.md)
+
+---
+
+# Live2D Cubism Core
+
+このフォルダーには、JavaScriptまたはTypeScriptアプリケーションを開発するためのコアライブラリファイルが含まれています。
+
+
+## ファイルリスト
+
+### live2dcubismcore.d.ts
+
+このファイルには、`live2dcubismcore.js`に関するTypeScriptの型情報が含まれています。
+TypeScriptで開発する場合は、このファイルを`live2dcubismcore.js`とともに使用してください。
+
+### live2dcubismcore.js
+
+このファイルには、CubismCoreの機能といくつかのラッパーが含まれています。
+JavaScriptで開発する場合は、このファイルを使用してください。
+
+### live2dcubismcore.js.map
+
+このファイルは、`live2dcubismcore.d.ts`と`live2dcubismcore.js`の間のソースマップです。
+デバッグ時にこのファイルを使用します。
+
+### live2dcubismcore.min.js
+
+このファイルは、`live2dcubismcore.js`のminify版です。
+このファイルを本番環境で使用します。

Core/README.md

@@ -1,3 +1,7 @@
+[English](README.md) / [日本語](README.ja.md)
+
+---
+
 # Live2D Cubism Core
 
 This folder contains core library files for developing JavaScript or TypeScript applications.
@@ -22,5 +26,5 @@ Use this file when debugging.
 
 ### live2dcubismcore.min.js
 
-This file is minified of `live2dcubismcore.js`.
+This file is the minified version of `live2dcubismcore.js`.
 Use this file in production.

NOTICE.ja.md

@@ -0,0 +1,22 @@
+[English](NOTICE.md) / [日本語](NOTICE.ja.md)
+
+---
+
+# お知らせ
+
+## [注意事項] Cubism 4 SDK for Web R1 以降へのアップデートに伴う注意
+
+Cubism 4 SDK for Web R1 にてそれ以前のベータ版から正式版のリリースに伴い、
+利便性向上のためパッケージ及びリポジトリの構造変更がおこなわれました。
+
+この変更は Cubism 4 SDK for Native と構造を変えずに運用がなされるほか、
+ユーザに管理が不必要なファイルが混在することを避けることが理由です。
+
+構造の変更点、及び Cubism 4 SDK for Web beta2 以前のプロジェクトからの更新方法に関して、
+[Cubism SDK Manual] に詳細を記載しています。アップデートを行う際は必ずご確認ください。
+
+[Cubism SDK Manual]: https://docs.live2d.com/cubism-sdk-manual/warning-for-cubism4-web-r1-update/
+
+---
+
+©Live2D

NOTICE.md

@@ -1,12 +1,19 @@
-## [注意事項] Cubism 4 SDK for Web R1 以降へのアップデートに伴う注意
+[English](NOTICE.md) / [日本語](NOTICE.ja.md)
 
-Cubism 4 SDK for Web R1 にてそれ以前のベータ版から正式版のリリースに伴い、
-利便性向上のためパッケージ及びリポジトリの構造変更がおこなわれました。
+---
 
-この変更は Cubism 4 SDK for Native と構造を変えずに運用がなされるほか、
-ユーザに管理が不必要なファイルが混在することを避けることが理由です。
+# Notices
 
-構造の変更点、及び Cubism 4 SDK for Web beta2 以前のプロジェクトからの更新方法に関して、
-[Cubism SDK Manual] に詳細を記載しています。アップデートを行う際は必ずご確認ください。
+## [Caution] Precautions for updating to Cubism 4 SDK for Web R1 or later
+
+With the release of the official version of the Cubism 4 SDK for Web R1 from the previous beta version, the structure of packages and repositories has been changed to improve usability.
+
+The reason for this change is to operate without changing the structure of Cubism 4 SDK for Native, and to avoid mixing files that do not require management by users.
+
+Details on structural changes and how to update from projects prior to Cubism 4 SDK for Web beta2 are described in the [Cubism SDK Manual]. Please be sure to check it when updating.
 
 [Cubism SDK Manual]: https://docs.live2d.com/cubism-sdk-manual/warning-for-cubism4-web-r1-update/
+
+---
+
+©Live2D

README.ja.md

@@ -0,0 +1,136 @@
+[English](README.md) / [日本語](README.ja.md)
+
+---
+
+# Cubism Web Samples
+
+Live2D Cubism 4 Editor で出力したモデルを表示するアプリケーションのサンプル実装です。
+
+Cubism Web Framework および Live2D Cubism Core と組み合わせて使用します。
+
+
+## ライセンス
+
+本 SDK を使用する前に、[ライセンス](LICENSE.md)をご確認ください。
+
+
+## お知らせ
+
+本 SDK を使用する前に、[お知らせ](NOTICE.ja.md)をご確認ください。
+
+
+## ディレクトリ構成
+
+```
+.
+├─ .vscode          # Visual Studio Code 用プロジェクト設定ディレクトリ
+├─ Core             # Live2D Cubism Core が含まれるディレクトリ
+├─ Framework        # レンダリングやアニメーション機能などのソースコードが含まれるディレクトリ
+└─ Samples
+   ├─ Resources     # モデルのファイルや画像などのリソースが含まれるディレクトリ
+   └─ TypeScript    # TypeScript のサンプルプロジェクトが含まれるディレクトリ
+```
+
+
+## Live2D Cubism Core for Web
+
+モデルをロードするためのライブラリです。
+
+当リポジトリではCubism Coreを管理していません。
+[こちら](https://www.live2d.com/download/cubism-sdk/download-web/)からCubism SDK for Webをダウンロードして、
+Coreディレクトリのファイルをコピーしてください。
+
+
+## 開発環境構築
+
+1. [Node.js] と [Visual Studio Code] をインストールします
+1. Visual Studio Code で **本 SDK のトップディレクトリ** を開き、推奨拡張機能をインストールします
+    * ポップアップ通知の他、拡張機能タブから `@recommended` を入力することで確認できます
+
+### サンプルデモの動作確認
+
+コマンドパレット（*View > Command Palette...*）で `>Tasks: Run Task` を入力することで、タスク一覧が表示されます。
+
+1. タスク一覧から　`npm: install - Samples/TypeScript/Demo` を選択して依存パッケージのダウンロードを行います
+1. タスク一覧から `npm: build - Samples/TypeScript/Demo` を選択してサンプルデモのビルドを行います
+1. タスク一覧から `npm: serve - Samples/TypeScript/Demo` を選択して動作確認用の簡易サーバを起動します
+1. ブラウザの URL 欄に `http://localhost:5000/Samples/TypeScript/Demo/` と入力してアクセスします
+1. コマンドパレットから `>Tasks: Terminate Task` を入力して `npm: serve` を選択すると簡易サーバが終了します
+
+その他のタスクに関してはサンプルプロジェクトの [README.md](Samples/TypeScript/README.ja.md) を参照ください。
+
+NOTE: デバック用の設定は、`.vscode/tasks.json` に記述しています。
+
+### プロジェクトのデバック
+
+Visual Studio Code で **本 SDK のトップディレクトリ** を開き、 *F5* キーを入力すると Debugger for Chrome が起動します。
+
+Visual Studio Code 上でブレイクポイントを貼って Chrome ブラウザと連動してデバックを行うことができます。
+
+NOTE: デバック用の設定は、`.vscode/launch.json` に記述しています。
+
+
+## SDKマニュアル
+
+[Cubism SDK Manual](https://docs.live2d.com/cubism-sdk-manual/top/)
+
+
+## 変更履歴
+
+当リポジトリの変更履歴については [CHANGELOG.md](CHANGELOG.md) を参照ください。
+
+
+## 開発環境
+
+### Node.js
+
+* 18.8.0
+* 16.17.0
+* 14.20.0
+
+
+## 動作確認環境
+
+| プラットフォーム | ブラウザ | バージョン |
+| --- | --- | --- |
+| Android | Google Chrome | 104.0.5112.97 |
+| Android | Microsoft Edge | 104.0.1293.63 |
+| Android | Mozilla Firefox | 104.1.0 |
+| iOS / iPadOS | Google Chrome | 104.0.5112.99 |
+| iOS / iPadOS | Microsoft Edge | 104.0.1293.63 |
+| iOS / iPadOS | Mozilla Firefox | 104.0 |
+| iOS / iPadOS | Safari | 15.6.1 |
+| macOS | Google Chrome | 104.0.5112.101 |
+| macOS | Microsoft Edge | 104.0.1293.70 |
+| macOS | Mozilla Firefox | 104.0 |
+| macOS | Safari | 15.6.1 |
+| Windows | Google Chrome | 104.0.5112.102 |
+| Windows | Microsoft Edge | 104.0.1293.70 |
+| Windows | Mozilla Firefox | 104.0 |
+
+Note: 動作確認時のサーバの起動は `./Samples/TypeScript/Demo/package.json` の `serve` スクリプトを使用して行っています。
+
+
+## プロジェクトへの貢献
+
+プロジェクトに貢献する方法はたくさんあります。バグのログの記録、このGitHubでのプルリクエストの送信、Live2Dコミュニティでの問題の報告と提案の作成です。
+
+### フォークとプルリクエスト
+
+修正、改善、さらには新機能をもたらすかどうかにかかわらず、プルリクエストに感謝します。ただし、ラッパーは可能な限り軽量で浅くなるように設計されているため、バグ修正とメモリ/パフォーマンスの改善のみを行う必要があることに注意してください。メインリポジトリを可能な限りクリーンに保つために、必要に応じて個人用フォークと機能ブランチを作成してください。
+
+### バグ
+
+Live2Dコミュニティでは、問題のレポートと機能リクエストを定期的にチェックしています。バグレポートを提出する前に、Live2Dコミュニティで検索して、問題のレポートまたは機能リクエストがすでに投稿されているかどうかを確認してください。問題がすでに存在する場合は、関連するコメントを追記してください。
+
+### 提案
+
+SDKの将来についてのフィードバックにも関心があります。Live2Dコミュニティで提案や機能のリクエストを送信できます。このプロセスをより効果的にするために、それらをより明確に定義するのに役立つより多くの情報を含めるようお願いしています。
+
+
+## コミュニティ
+
+ユーザー同士でCubism SDKの活用方法の提案や質問をしたい場合は、是非コミュニティをご活用ください。
+
+- [Live2D 公式コミュニティ](https://creatorsforum.live2d.com/)
+- [Live2D community(English)](https://community.live2d.com/)