Blockly はオープンソースであり、主に少人数のチームによってメンテナンスされています。コアチーム以外のデベロッパーからの貢献を歓迎します。コミュニティなしでは、リクエストされたすべての機能を構築したり、報告されたすべてのバグを修正したりすることはできません。このセクションでは、オープンソース開発を初めて行う場合に役立つ一般的なガイドについて説明します。
コントリビューションを行う前に確認すべき Blockly 固有の情報については、Core へのコントリビューションとサンプルへのコントリビューションのセクションをご覧ください。
どのリポジトリですか？
リポジトリには、単一のプロジェクトのすべてのファイルが含まれます。Blockly には、blockly core と blockly-samples の 2 つのリポジトリがあります。
Blockly core は、Blockly ライブラリのリポジトリです。ライブラリのすべてのユーザーに適用されるように、Blockly のコア動作を変更する場合は、このリポジトリを使用します。
Blockly サンプルは、サンプル、プラグイン、Codelab のリポジトリです。プラグインの作成または変更、Codelab の作成、サンプルの作成または変更を行う場合は、このリポジトリを使用します。
詳細な手順
変更を加える際の一般的な手順は次のとおりです。
- [ツール] セクションのリンクに沿って、Git と Node をインストールします。
- リポジトリをフォークしてクローンを作成します。GitHub には、リポジトリのフォークに関する優れたチュートリアルがあります。これを Blockly に適用するには、使用するリポジトリに応じて、octocat/Spoon-Knife のすべてのインスタンスを google/blockly または google/blockly-samples に置き換えます。
- フォークを同期します。GitHub には、フォークの同期に関するチュートリアルもあります。
- メインブランチをチェックアウトします。Blockly コアでは、これは
developブランチです。blockly-samples では、これはmasterブランチです。 - ルート ディレクトリで
npm installを実行して、依存関係とビルドツールをインストールします。 - ターミナルで
git checkout -b myBranchNameを実行して、新しいブランチを作成します。作業内容を思い出しやすい名前にします。 - 変更を加えます。
- コアまたはサンプルのガイドに沿って、変更を検証します。
git commit -am "fix: My commit message"を使用して変更を保存します。commit メッセージの詳細git push origin myBranchNameを使用して、GitHub に変更を push します。- コードの準備ができたら、プルリクエストを開く。Blockly チームのメンバーが変更内容を確認し、承認された場合は Blockly に統合します。詳しくは、PR 審査プロセスをご覧ください。