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