{"id":24973410,"url":"https://github.com/ishix-g/unity-githubactions","last_synced_at":"2025-12-15T16:52:18.893Z","repository":{"id":274561669,"uuid":"923037534","full_name":"IShix-g/Unity-GitHubActions","owner":"IShix-g","description":"Automate Unity Package Releases Using GitHub Actions. GitHubアクションを使ってUnityパッケージのリリースを自動化","archived":false,"fork":false,"pushed_at":"2025-03-14T01:52:53.000Z","size":7067,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-14T02:36:31.462Z","etag":null,"topics":["github-actions","unity","unity3d"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/IShix-g.png","metadata":{"files":{"readme":"Docs/README_jp.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-01-27T14:38:56.000Z","updated_at":"2025-03-14T01:52:57.000Z","dependencies_parsed_at":"2025-01-28T03:27:36.022Z","dependency_job_id":"e56a116d-7f83-45e0-bcbe-872e60b19696","html_url":"https://github.com/IShix-g/Unity-GitHubActions","commit_stats":null,"previous_names":["ishix-g/unity-githubactions"],"tags_count":92,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IShix-g%2FUnity-GitHubActions","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IShix-g%2FUnity-GitHubActions/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IShix-g%2FUnity-GitHubActions/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IShix-g%2FUnity-GitHubActions/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/IShix-g","download_url":"https://codeload.github.com/IShix-g/Unity-GitHubActions/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246148428,"owners_count":20731154,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["github-actions","unity","unity3d"],"created_at":"2025-02-03T18:59:24.571Z","updated_at":"2025-12-15T16:52:18.883Z","avatar_url":"https://github.com/IShix-g.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# Unity-GitHubActions\nGitHub Actions for Unity.\n\n![](logo.png)\n\n## 目次\n\n\u003c!-- START doctoc generated TOC please keep comment here to allow auto update --\u003e\n\u003c!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE --\u003e\n\u003cdetails\u003e\n\u003csummary\u003eDetails\u003c/summary\u003e\n\n- [実現すること](#%E5%AE%9F%E7%8F%BE%E3%81%99%E3%82%8B%E3%81%93%E3%81%A8)\n  - [リリースノート](#%E3%83%AA%E3%83%AA%E3%83%BC%E3%82%B9%E3%83%8E%E3%83%BC%E3%83%88)\n    - [利用可能なタイプ一覧](#%E5%88%A9%E7%94%A8%E5%8F%AF%E8%83%BD%E3%81%AA%E3%82%BF%E3%82%A4%E3%83%97%E4%B8%80%E8%A6%A7)\n- [必須の設定](#%E5%BF%85%E9%A0%88%E3%81%AE%E8%A8%AD%E5%AE%9A)\n- [環境別の設定](#%E7%92%B0%E5%A2%83%E5%88%A5%E3%81%AE%E8%A8%AD%E5%AE%9A)\n  - [ブランチ保護またはタグ保護が有効な場合](#%E3%83%96%E3%83%A9%E3%83%B3%E3%83%81%E4%BF%9D%E8%AD%B7%E3%81%BE%E3%81%9F%E3%81%AF%E3%82%BF%E3%82%B0%E4%BF%9D%E8%AD%B7%E3%81%8C%E6%9C%89%E5%8A%B9%E3%81%AA%E5%A0%B4%E5%90%88)\n  - [Test Framework (旧 Test Runner)またはパッケージを生成したい場合](#test-framework-%E6%97%A7-test-runner%E3%81%BE%E3%81%9F%E3%81%AF%E3%83%91%E3%83%83%E3%82%B1%E3%83%BC%E3%82%B8%E3%82%92%E7%94%9F%E6%88%90%E3%81%97%E3%81%9F%E3%81%84%E5%A0%B4%E5%90%88)\n  - [必要情報](#%E5%BF%85%E8%A6%81%E6%83%85%E5%A0%B1)\n- [Unityパッケージのビルドは必要？](#unity%E3%83%91%E3%83%83%E3%82%B1%E3%83%BC%E3%82%B8%E3%81%AE%E3%83%93%E3%83%AB%E3%83%89%E3%81%AF%E5%BF%85%E8%A6%81)\n- [手動でのリリース](#%E6%89%8B%E5%8B%95%E3%81%A7%E3%81%AE%E3%83%AA%E3%83%AA%E3%83%BC%E3%82%B9)\n  - [手動でリリースまでの流れ](#%E6%89%8B%E5%8B%95%E3%81%A7%E3%83%AA%E3%83%AA%E3%83%BC%E3%82%B9%E3%81%BE%E3%81%A7%E3%81%AE%E6%B5%81%E3%82%8C)\n  - [セットアップガイド](#%E3%82%BB%E3%83%83%E3%83%88%E3%82%A2%E3%83%83%E3%83%97%E3%82%AC%E3%82%A4%E3%83%89)\n- [プルリクエストでのリリース](#%E3%83%97%E3%83%AB%E3%83%AA%E3%82%AF%E3%82%A8%E3%82%B9%E3%83%88%E3%81%A7%E3%81%AE%E3%83%AA%E3%83%AA%E3%83%BC%E3%82%B9)\n  - [リリース作成の条件](#%E3%83%AA%E3%83%AA%E3%83%BC%E3%82%B9%E4%BD%9C%E6%88%90%E3%81%AE%E6%9D%A1%E4%BB%B6)\n  - [プルリクエストを介したリリースの流れ](#%E3%83%97%E3%83%AB%E3%83%AA%E3%82%AF%E3%82%A8%E3%82%B9%E3%83%88%E3%82%92%E4%BB%8B%E3%81%97%E3%81%9F%E3%83%AA%E3%83%AA%E3%83%BC%E3%82%B9%E3%81%AE%E6%B5%81%E3%82%8C)\n  - [セットアップガイド](#%E3%82%BB%E3%83%83%E3%83%88%E3%82%A2%E3%83%83%E3%83%97%E3%82%AC%E3%82%A4%E3%83%89-1)\n- [推奨事項](#%E6%8E%A8%E5%A5%A8%E4%BA%8B%E9%A0%85)\n- [Unity Test Framework (旧 Test Runner)の実行を追加する](#unity-test-framework-%E6%97%A7-test-runner%E3%81%AE%E5%AE%9F%E8%A1%8C%E3%82%92%E8%BF%BD%E5%8A%A0%E3%81%99%E3%82%8B)\n  - [テストについて](#%E3%83%86%E3%82%B9%E3%83%88%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6)\n  - [Workflowの参考](#workflow%E3%81%AE%E5%8F%82%E8%80%83)\n  - [現在のWorkflowに追加する場合](#%E7%8F%BE%E5%9C%A8%E3%81%AEworkflow%E3%81%AB%E8%BF%BD%E5%8A%A0%E3%81%99%E3%82%8B%E5%A0%B4%E5%90%88)\n  - [Modeを指定したい](#mode%E3%82%92%E6%8C%87%E5%AE%9A%E3%81%97%E3%81%9F%E3%81%84)\n    - [コード例 (初期値)](#%E3%82%B3%E3%83%BC%E3%83%89%E4%BE%8B-%E5%88%9D%E6%9C%9F%E5%80%A4)\n    - [実行結果のサンプル](#%E5%AE%9F%E8%A1%8C%E7%B5%90%E6%9E%9C%E3%81%AE%E3%82%B5%E3%83%B3%E3%83%97%E3%83%AB)\n- [パッケージの生成を追加する](#%E3%83%91%E3%83%83%E3%82%B1%E3%83%BC%E3%82%B8%E3%81%AE%E7%94%9F%E6%88%90%E3%82%92%E8%BF%BD%E5%8A%A0%E3%81%99%E3%82%8B)\n  - [パッケージの生成について](#%E3%83%91%E3%83%83%E3%82%B1%E3%83%BC%E3%82%B8%E3%81%AE%E7%94%9F%E6%88%90%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6)\n  - [\u0026#91;注意\u0026#93; パッケージが生成できない環境](#%E6%B3%A8%E6%84%8F-%E3%83%91%E3%83%83%E3%82%B1%E3%83%BC%E3%82%B8%E3%81%8C%E7%94%9F%E6%88%90%E3%81%A7%E3%81%8D%E3%81%AA%E3%81%84%E7%92%B0%E5%A2%83)\n    - [パスの例](#%E3%83%91%E3%82%B9%E3%81%AE%E4%BE%8B)\n  - [現在のWorkflowに追加する場合](#%E7%8F%BE%E5%9C%A8%E3%81%AEworkflow%E3%81%AB%E8%BF%BD%E5%8A%A0%E3%81%99%E3%82%8B%E5%A0%B4%E5%90%88-1)\n  - [Unity Editorで必須の設定](#unity-editor%E3%81%A7%E5%BF%85%E9%A0%88%E3%81%AE%E8%A8%AD%E5%AE%9A)\n  - [実行結果のサンプル](#%E5%AE%9F%E8%A1%8C%E7%B5%90%E6%9E%9C%E3%81%AE%E3%82%B5%E3%83%B3%E3%83%97%E3%83%AB-1)\n- [PackageExporter](#packageexporter)\n  - [インストール](#%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB)\n    - [\u0026#91;おすすめ\u0026#93; パッケージマネージャー](#%E3%81%8A%E3%81%99%E3%81%99%E3%82%81-%E3%83%91%E3%83%83%E3%82%B1%E3%83%BC%E3%82%B8%E3%83%9E%E3%83%8D%E3%83%BC%E3%82%B8%E3%83%A3%E3%83%BC)\n    - [パッケージをダウンロード](#%E3%83%91%E3%83%83%E3%82%B1%E3%83%BC%E3%82%B8%E3%82%92%E3%83%80%E3%82%A6%E3%83%B3%E3%83%AD%E3%83%BC%E3%83%89)\n  - [\u0026#91;必須\u0026#93; 出力テストの実行](#%E5%BF%85%E9%A0%88-%E5%87%BA%E5%8A%9B%E3%83%86%E3%82%B9%E3%83%88%E3%81%AE%E5%AE%9F%E8%A1%8C)\n- [C\u0026#035;のスタイルチェック](#c%E3%81%AE%E3%82%B9%E3%82%BF%E3%82%A4%E3%83%AB%E3%83%81%E3%82%A7%E3%83%83%E3%82%AF)\n  - [スタイルチェックとは？](#%E3%82%B9%E3%82%BF%E3%82%A4%E3%83%AB%E3%83%81%E3%82%A7%E3%83%83%E3%82%AF%E3%81%A8%E3%81%AF)\n- [プルリクエストでスタイルチェック](#%E3%83%97%E3%83%AB%E3%83%AA%E3%82%AF%E3%82%A8%E3%82%B9%E3%83%88%E3%81%A7%E3%82%B9%E3%82%BF%E3%82%A4%E3%83%AB%E3%83%81%E3%82%A7%E3%83%83%E3%82%AF)\n  - [実行サンプル](#%E5%AE%9F%E8%A1%8C%E3%82%B5%E3%83%B3%E3%83%97%E3%83%AB)\n  - [スタイルチェックの対象](#%E3%82%B9%E3%82%BF%E3%82%A4%E3%83%AB%E3%83%81%E3%82%A7%E3%83%83%E3%82%AF%E3%81%AE%E5%AF%BE%E8%B1%A1)\n  - [スタイルチェックの流れ](#%E3%82%B9%E3%82%BF%E3%82%A4%E3%83%AB%E3%83%81%E3%82%A7%E3%83%83%E3%82%AF%E3%81%AE%E6%B5%81%E3%82%8C)\n  - [セットアップガイド](#%E3%82%BB%E3%83%83%E3%83%88%E3%82%A2%E3%83%83%E3%83%97%E3%82%AC%E3%82%A4%E3%83%89-2)\n- [手動実行でスタイルチェック](#%E6%89%8B%E5%8B%95%E5%AE%9F%E8%A1%8C%E3%81%A7%E3%82%B9%E3%82%BF%E3%82%A4%E3%83%AB%E3%83%81%E3%82%A7%E3%83%83%E3%82%AF)\n  - [実行サンプル](#%E5%AE%9F%E8%A1%8C%E3%82%B5%E3%83%B3%E3%83%97%E3%83%AB-1)\n  - [スタイルチェックの対象](#%E3%82%B9%E3%82%BF%E3%82%A4%E3%83%AB%E3%83%81%E3%82%A7%E3%83%83%E3%82%AF%E3%81%AE%E5%AF%BE%E8%B1%A1-1)\n  - [スタイルチェックの流れ](#%E3%82%B9%E3%82%BF%E3%82%A4%E3%83%AB%E3%83%81%E3%82%A7%E3%83%83%E3%82%AF%E3%81%AE%E6%B5%81%E3%82%8C-1)\n  - [セットアップガイド](#%E3%82%BB%E3%83%83%E3%83%88%E3%82%A2%E3%83%83%E3%83%97%E3%82%AC%E3%82%A4%E3%83%89-3)\n- [タグの更新](#%E3%82%BF%E3%82%B0%E3%81%AE%E6%9B%B4%E6%96%B0)\n  - [ローカルでのタグ確認](#%E3%83%AD%E3%83%BC%E3%82%AB%E3%83%AB%E3%81%A7%E3%81%AE%E3%82%BF%E3%82%B0%E7%A2%BA%E8%AA%8D)\n- [Jobの説明](#job%E3%81%AE%E8%AA%AC%E6%98%8E)\n  - [タグの検証 (Validate Tag)](#%E3%82%BF%E3%82%B0%E3%81%AE%E6%A4%9C%E8%A8%BC-validate-tag)\n    - [入力値 (Inputs)](#%E5%85%A5%E5%8A%9B%E5%80%A4-inputs)\n    - [出力値 (Outputs)](#%E5%87%BA%E5%8A%9B%E5%80%A4-outputs)\n  - [package.json の更新 (Update package.json)](#packagejson-%E3%81%AE%E6%9B%B4%E6%96%B0-update-packagejson)\n    - [入力値 (Inputs)](#%E5%85%A5%E5%8A%9B%E5%80%A4-inputs-1)\n    - [Secrets (機密情報)](#secrets-%E6%A9%9F%E5%AF%86%E6%83%85%E5%A0%B1)\n    - [出力値 (Outputs)](#%E5%87%BA%E5%8A%9B%E5%80%A4-outputs-1)\n  - [マージとプッシュ (Merge and Push)](#%E3%83%9E%E3%83%BC%E3%82%B8%E3%81%A8%E3%83%97%E3%83%83%E3%82%B7%E3%83%A5-merge-and-push)\n    - [入力値 (Inputs)](#%E5%85%A5%E5%8A%9B%E5%80%A4-inputs-2)\n    - [Secrets (機密情報)](#secrets-%E6%A9%9F%E5%AF%86%E6%83%85%E5%A0%B1-1)\n    - [出力値 (Outputs)](#%E5%87%BA%E5%8A%9B%E5%80%A4-outputs-2)\n  - [リリースノート生成 (Release Notes Generator)](#%E3%83%AA%E3%83%AA%E3%83%BC%E3%82%B9%E3%83%8E%E3%83%BC%E3%83%88%E7%94%9F%E6%88%90-release-notes-generator)\n    - [入力値 (Inputs)](#%E5%85%A5%E5%8A%9B%E5%80%A4-inputs-3)\n    - [出力値 (Outputs)](#%E5%87%BA%E5%8A%9B%E5%80%A4-outputs-3)\n  - [リリース作成 (Create Release)](#%E3%83%AA%E3%83%AA%E3%83%BC%E3%82%B9%E4%BD%9C%E6%88%90-create-release)\n    - [入力値 (Inputs)](#%E5%85%A5%E5%8A%9B%E5%80%A4-inputs-4)\n    - [Secrets (機密情報)](#secrets-%E6%A9%9F%E5%AF%86%E6%83%85%E5%A0%B1-2)\n  - [Unityテストの実行 (Unity Test Framework)](#unity%E3%83%86%E3%82%B9%E3%83%88%E3%81%AE%E5%AE%9F%E8%A1%8C-unity-test-framework)\n    - [このWorkflowについて](#%E3%81%93%E3%81%AEworkflow%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6)\n    - [入力値 (Inputs)](#%E5%85%A5%E5%8A%9B%E5%80%A4-inputs-5)\n    - [Secrets (機密情報)](#secrets-%E6%A9%9F%E5%AF%86%E6%83%85%E5%A0%B1-3)\n  - [パッケージの生成 (Build Package)](#%E3%83%91%E3%83%83%E3%82%B1%E3%83%BC%E3%82%B8%E3%81%AE%E7%94%9F%E6%88%90-build-package)\n    - [入力値 (Inputs)](#%E5%85%A5%E5%8A%9B%E5%80%A4-inputs-6)\n    - [出力値 (Outputs)](#%E5%87%BA%E5%8A%9B%E5%80%A4-outputs-4)\n    - [Secrets (機密情報)](#secrets-%E6%A9%9F%E5%AF%86%E6%83%85%E5%A0%B1-4)\n  - [パッケージのアップロード (Upload package to release)](#%E3%83%91%E3%83%83%E3%82%B1%E3%83%BC%E3%82%B8%E3%81%AE%E3%82%A2%E3%83%83%E3%83%97%E3%83%AD%E3%83%BC%E3%83%89-upload-package-to-release)\n    - [入力値 (Inputs)](#%E5%85%A5%E5%8A%9B%E5%80%A4-inputs-7)\n      - [SHA-256ハッシュの生成](#sha-256%E3%83%8F%E3%83%83%E3%82%B7%E3%83%A5%E3%81%AE%E7%94%9F%E6%88%90)\n  - [C\u0026#035;ファイルのスタイルチェック (Lint C# Files for Unity)](#c%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%81%AE%E3%82%B9%E3%82%BF%E3%82%A4%E3%83%AB%E3%83%81%E3%82%A7%E3%83%83%E3%82%AF-lint-c-files-for-unity)\n    - [使用しているOSS](#%E4%BD%BF%E7%94%A8%E3%81%97%E3%81%A6%E3%81%84%E3%82%8Boss)\n    - [入力値 (Inputs)](#%E5%85%A5%E5%8A%9B%E5%80%A4-inputs-8)\n  - [メジャータグの更新 (Update Major Tag)](#%E3%83%A1%E3%82%B8%E3%83%A3%E3%83%BC%E3%82%BF%E3%82%B0%E3%81%AE%E6%9B%B4%E6%96%B0-update-major-tag)\n    - [入力値 (Inputs)](#%E5%85%A5%E5%8A%9B%E5%80%A4-inputs-9)\n    - [自動でタグを更新](#%E8%87%AA%E5%8B%95%E3%81%A7%E3%82%BF%E3%82%B0%E3%82%92%E6%9B%B4%E6%96%B0)\n    - [Secrets (機密情報)](#secrets-%E6%A9%9F%E5%AF%86%E6%83%85%E5%A0%B1-5)\n    - [ローカルでのタグ確認](#%E3%83%AD%E3%83%BC%E3%82%AB%E3%83%AB%E3%81%A7%E3%81%AE%E3%82%BF%E3%82%B0%E7%A2%BA%E8%AA%8D-1)\n- [GitHub Actionsの使用料について](#github-actions%E3%81%AE%E4%BD%BF%E7%94%A8%E6%96%99%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6)\n- [参考リポジトリ](#%E5%8F%82%E8%80%83%E3%83%AA%E3%83%9D%E3%82%B8%E3%83%88%E3%83%AA)\n\n\u003c/details\u003e\n\u003c!-- END doctoc generated TOC please keep comment here to allow auto update --\u003e\n\n## 実現すること\n\nGitHubアクションを使った、Unityパッケージのリリース自動化  \n\n**このアクションは以下のタスクを自動化します。**\n\n- [パッケージマニフェスト](https://docs.unity3d.com/2022.3/Documentation/Manual/upm-manifestPkg.html)のバージョンを更新する\n- リリースを生成する\n- タグを作成する\n- [Unity Test Framework (旧 Test Runner)](https://docs.unity3d.com/2022.3/Documentation/Manual/testing-editortestsrunner.html)でテストを実行する\n- [パッケージ](https://docs.unity3d.com/2022.3/Documentation/Manual/CustomPackages.html)の生成をする\n- [パッケージ](https://docs.unity3d.com/2022.3/Documentation/Manual/CustomPackages.html)をリリースページにアップロードする\n- [C#のスタイルチェックをする](#cのスタイルチェック)\n\n利用したいタスクのみ実行可能です。\n\n### リリースノート\n\nコミットメッセージを `feat` や `fix` といったキーワードで始めることで、自動的にリリースノートに含まれるようになります。\n\n#### 利用可能なタイプ一覧\n\n| Type       | Description                |\n|------------|----------------------------|\n| feat:      | 新機能の追加                     |\n| fix:       | バグの修正                      |\n| docs:      | ドキュメントの更新や修正           |\n| style:     | コードスタイルの調整(空白の削除など)  |\n| refactor:  | バグ修正でも機能追加でもないコード変更 |\n| perf:      | パフォーマンス向上のための変更        |\n\n\u003cimg src=\"release-note.jpg\" width=\"500\"/\u003e\n\n## 必須の設定\n\n`Settings \u003e Actions \u003e General \u003e Workflow permissions`で **Read and write permissions** に設定してください。\n\n\u003cimg src=\"settings_action.jpg\" width=\"500\"/\u003e\n\n## 環境別の設定\n\n### ブランチ保護またはタグ保護が有効な場合\n\nデフォルトではパーミッションエラーが発生します。これを回避するには、GitHub Appsでこれらの保護ルールを回避できるように設定します。\n\n- [GitHub App](https://docs.github.com/en/apps/creating-github-apps/about-creating-github-apps/about-creating-github-apps)を作成する\n- アプリをインストールし、対象のリポジトリを設定する\n- リポジトリのSecretsに `BOT_APP_ID` と `BOT_PRIVATE_KEY` を設定する\n- GitHub App が保護ルールをバイパスできるように更新する\n\n詳しくは[GitHubApp.md](GitHubApp_jp.md)をご覧ください。\n\n### Test Framework (旧 Test Runner)またはパッケージを生成したい場合\n\nUnityをバッチモードで実行する必要がありUnityのアカウント情報が必要です。  \n[Activation](https://game.ci/docs/github/activation)を参考に必要情報を取得しリポジトリに設定してください。  \nまたテストの実行、パッケージの生成に[GameCI](https://game.ci/docs/github/builder)を利用しています。\n\n### 必要情報\n\nライセンスの種類で`UNITY_LICENSE`または`UNITY_SERIAL`のいずれかが必要です。\nリポジトリのSecretsに設定してください。\n\n| Name           |  Description                   |\n|----------------|---------------------|\n| UNITY_EMAIL    | UnityにログインするE-mail  |\n| UNITY_PASSWORD | Unityにログインするパスワード   |\n| UNITY_LICENSE  | ライセンスがPersonalの場合必要 |\n| UNITY_SERIAL   | ライセンスがProの場合必要      |\n\n## Unityパッケージのビルドは必要？\n\nUnity2018以降、[Package Manager (UPM)](https://docs.unity3d.com/2022.3/Documentation/Manual/Packages.html) でパッケージ管理が可能となり、現在ではほとんどのUnityバージョンでUPMが使用できます。そのため、従来のUnityパッケージ生成はほぼ不要となり、提供するメインのWorkflowにはUnityパッケージのリリースは含まないようにしています。\n\n___\n\n## 手動でのリリース\n\n[build-release_merge.yaml](https://github.com/IShix-g/Unity-GitHubActions/blob/main/.github/workflows/build-release_merge.yaml)\n\n```mermaid\ngraph LR\n    validate-branch --\u003e update-packagejson\n    update-packagejson --\u003e merge-and-push\n    merge-and-push --\u003e release-notes\n    release-notes --\u003e create-release\n    create-release --\u003e clean-branch\n```\n\nActionsタブに移動し、`Manual Release (Merge to Default)` \u003e `Run workflow`を選択して手動でリリースをおこないます。  \n\n[実行結果のサンプル](https://github.com/IShix-g/Unity-GitHubActions/actions/runs/13129242127)\n\n\u003cimg src=\"release_manually.jpg\" width=\"500\"/\u003e\n\n| Option                | Description                                                                                                                                                                                                                                        | Default            | Example  |\n|-----------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|----------|\n| tag| 作成したいGitタグ                                                                                                                                                                                                                                         |                    | 1.0.0                                        |\n| clean-branch | ブランチを削除しますか？デフォルトブランチ以外のすべてのブランチが削除されます                                                                                                                                                                                                            | false | |\n| fast-forward | 可能であれば[fast-forward](https://docs.github.com/en/enterprise-cloud@latest/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/about-merge-methods-on-github#rebasing-and-merging-your-commits)マージを許可するか？ | false              | |\n| include-default-branch| デフォルト・ブランチをワークフローの動作に含める                                                                                                                                                                                                                           | false              ||\n| dry-run | 変更をコミットまたはプッシュせずにマージをシミュレートする                                                                                                                                                                                                                      | false              ||\n| draft-release | ドラフトリリースの場合は `true`, 非ドラフトリリースの場合は `false`                                                                                                                                                                                                         | false              |\n\n### 手動でリリースまでの流れ\n\n1. ブランチを作成する (例: `release`)\n2. このブランチでリリースを準備する\n3. `Run workflow` を使って手動リリースをトリガーする\n\n\u003cimg src=\"release_manually2.jpg\" width=\"500\"/\u003e\n\n### セットアップガイド\n\n1. [.github/workflows/build-release_merge.yaml](https://github.com/IShix-g/Unity-GitHubActions/blob/main/.github/workflows/build-release_merge.yaml) からコードをコピーし、プロジェクトの `.github/workflows` フォルダに YAML ファイルを作成\n2. プロジェクト構造に合うように、`update-packagejson` 内の `file-path` を更新\n3. ブランチ保護ルールを使用していない場合、`secrets.BOT_APP_ID` および `secrets.BOT_PRIVATE_KEY` に関する記述を削除してください。\n\n※ 実行時にパーミッションエラーが発生した場合は、[permissions](https://docs.github.com/en/actions/writing-workflows/choosing-what-your-workflow-does/controlling-permissions-for-github_token) を構成してください。\n\n## プルリクエストでのリリース\n\n[build-release_pull-request.yaml](https://github.com/IShix-g/Unity-GitHubActions/blob/main/.github/workflows/build-release_pull-request.yaml)\n\n```mermaid\ngraph LR\n    extract-tag --\u003e update-packagejson\n    update-packagejson --\u003e release-notes\n    release-notes --\u003e create-release\n```\n\n任意のブランチからデフォルトブランチへのプルリクエストを作成します。**リリースタイトルにタグ名**（例: `1.0.0`）を使用する必要があります。このプルリクエストがマージされると、リリースが自動で作成されます。\n\n[実行結果のサンプル](https://github.com/IShix-g/Unity-GitHubActions/actions/runs/13323524820)\n\n\u003cimg src=\"pull_request.jpg\" width=\"500\"/\u003e\n\nプルリクエストをマージ後、リリースが自動的に作成されます。\n\n\u003cimg src=\"pull_request2.jpg\" width=\"500\"/\u003e\n\n### リリース作成の条件\n\n以下の条件が満たされた場合、リリースが作成されます:\n- プルリクエストのタイトルにバージョン番号が含まれている（例: `1.0.0`）\n- ベースブランチが[デフォルトブランチ](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-branches-in-your-repository/changing-the-default-branch)である\n\n### プルリクエストを介したリリースの流れ\n\n1. ブランチを作成します（例: `release`）\n2. このブランチでリリースを準備します\n3. このブランチをデフォルトブランチへマージするプルリクエストを作成します。タイトルをバージョン番号にする(例: `v1.0.0`)\n4. プルリクエストのマージ\n5. リリースが自動的に生成されます\n\n### セットアップガイド\n\n1. [.github/workflows/build-release_pull-request.yaml](https://github.com/IShix-g/Unity-GitHubActions/blob/main/.github/workflows/build-release_pull-request.yaml) からコードをコピーし、プロジェクトの `.github/workflows` フォルダに YAML ファイルを作成します。\n2. `update-packagejson` 内の `file-path` を、プロジェクトのファイル構造に合わせて更新します。\n3. ブランチの保護ルールを使用していない場合、`secrets.BOT_APP_ID` および `secrets.BOT_PRIVATE_KEY` に関する記述は削除してください。\n\n※ 実行時にパーミッションエラーが発生した場合は、[permissions](https://docs.github.com/en/actions/writing-workflows/choosing-what-your-workflow-does/controlling-permissions-for-github_token) を構成してください。\n\n## 推奨事項\n\nプルリクエストでのリリースを使用する場合でも、フォールバック手段として手動リリースも合わせて構成することをお勧めします。\n\n## Unity Test Framework (旧 Test Runner)の実行を追加する\n\nUnityEditor上のテストを実行します。利用には[設定](#test-framework-旧-test-runnerまたはパッケージを生成したい場合)が必要です。\n\n### テストについて\n\nGameCIの[Test Runner](https://game.ci/docs/github/test-runner)を利用してテストを実行します。  \n実行するテストを指定する必要はなくUnityEditor上で作成したEdit Test、Play Testのいずれかまたはすべてを実行します。\n\n### Workflowの参考\n\n[build-release_merge_test.yaml](https://github.com/IShix-g/Unity-GitHubActions/blob/main/.github/workflows/build-release_merge_test.yaml) を参考に実装ください。\n\n### 現在のWorkflowに追加する場合\n\n- `permissions`に`checks: write`を追加\n- `unity-test`Jobを追加\n- `unity-version`にUnity Editorのバージョンを指定 (例: `2021.3.45f1`)\n\nUnity Editorの対応バージョンは[こちら](https://game.ci/docs/docker/versions)から確認できます。\n\n### Modeを指定したい\n\n初期値では、Edit mode、Play Mode両方のテストを実行します。\n選択したい場合は、`test-modes`を指定してください。\n指定できるパラメータは、[Game CI - testMode](https://game.ci/docs/github/test-runner/#testmode)で確認できます。\n複数指定する場合は、`,`で区切ってください。\n\n#### コード例 (初期値)\n```yaml\ntest-modes: 'playmode,editmode'\n```\n#### 実行結果のサンプル\n\n実行したテスト一覧の確認  \n[実行結果のサンプル](https://github.com/IShix-g/Unity-GitHubActions/actions/runs/13325816869)\n\n\u003cimg src=\"artifact-editmode.jpg\" width=\"500\"/\u003e\n\n[Unity - Code Coverage](https://docs.unity3d.com/Packages/com.unity.testtools.codecoverage@1.2/manual/index.html)がArtifactsに表示されます。\n\n\u003cimg src=\"artifact-download.jpg\" width=\"500\"/\u003e\n\n## パッケージの生成を追加する\n\n[build-release_merge_package.yaml](https://github.com/IShix-g/Unity-GitHubActions/blob/main/.github/workflows/build-release_merge_package.yaml)を参考に実装ください。利用には[設定](#test-framework-旧-test-runnerまたはパッケージを生成したい場合)が必要です。  \nパッケージの生成では、以下を達成できるようにします。\n\n- パッケージの生成 ([UPM package](https://docs.unity3d.com/2022.3/Documentation/Manual/upm-ui-install.html))\n- 生成したパッケージをリリースページのAssetsに追加\n\n### パッケージの生成について\n\nGameCIの[Builder](https://game.ci/docs/github/builder)を利用してパッケージを生成しています。\n\n### [注意] パッケージが生成できない環境\n\nUnityEditor上でのパッケージのパスが、`Assets`配下で無い場合生成できないので使えません。\n\n#### パスの例\n\n- [生成できる] `Assets/MyPackage/`\n- [生成できない] `Packages/MyPackage/`\n\n### 現在のWorkflowに追加する場合\n\n- `build-package`Jobの追加\n- `package-name`に拡張子無しのパッケージ名を指定 (例: `TestPackage`)\n- `unity-version`にUnity Editorのバージョンを指定 (例: `2021.3.45f1`)\n- `release-package-upload`Jobの追加\n\nUnity Editorの対応バージョンは[こちら](https://game.ci/docs/docker/versions)から確認できます。\n\n### Unity Editorで必須の設定\n\nパッケージを生成するスクリプトが必要です。[PackageExporter](#packageexporter)を用意しているのでご利用ください。\n\n### 実行結果のサンプル\n\nリリースにビルドしたパッケージが表示されます。  \n[実行結果のサンプル](https://github.com/IShix-g/Unity-GitHubActions/actions/runs/13320955403)\n\n\u003cimg src=\"release_page.jpg\" width=\"500\"/\u003e\n\n## PackageExporter\n\nパッケージを生成するスクリプトです。Editorでのみ機能し、ビルドには何も追加しない軽量のプラグインです。\n\n### インストール\nいずれかの方法でインストールください。\n\n#### [おすすめ] パッケージマネージャー\n\nUnity Editorで\"Window \u003e Package Manager \u003e Add package from git URL...\"にURLを入力してインストールしてください。\n\n```\nhttps://github.com/IShix-g/Unity-GitHubActions.git?path=Assets/PackageExporter\n```\n\n#### パッケージをダウンロード\n\n[リリースページ](https://github.com/IShix-g/Unity-GitHubActions/releases)のAssetsにある`PackageExporter_xxx.unitypackage`をダウンロードしてインストールしてください。\n\n### [必須] 出力テストの実行\n\n- Unity EditorのWindow \u003e Test Export Packageを開く\n- 必要情報を入力しExportの実行\n- コンソールにエラーが出ず、パッケージの出力先パスが表示されれば成功です\n\n出力したパッケージを適当なプロジェクトにインストールして問題が無いか確認ください。\n\n## C#のスタイルチェック\n\n### スタイルチェックとは？\n\n- プライベートフィールドは、`_myField`のように「`_` + キャメルケース」で記述してほしい\n- `if`文は必ず`{}`で囲ってほしい\n- インデントはタブではなくスペースを使ってほしい\n\nなど、チームならではのルールがあると思います。  \nそれをプルリクエストや、手動実行をトリガーにスタイルチェックをさせる事でレビュワーの負担を減らせます。\n\n## プルリクエストでスタイルチェック\n\n[lint-unity-cs-pull-request.yaml](https://github.com/IShix-g/Unity-GitHubActions/blob/main/.github/workflows/lint-unity-cs-pull-request.yaml)\n\n### 実行サンプル\n\nスタイルに問題があった場合、アクションが失敗しプルリクエストにコメントが表示されます。\n\n\u003cimg src=\"pull_request_style_check.jpg\" width=\"500\"/\u003e\n\n### スタイルチェックの対象\n\nコミットされた新ファイルまたは修正された`.cs`ファイルに対してスタイルチェックが走ります。\n\n### スタイルチェックの流れ\n\n- プルリクエストを作成してもらう\n- 作成したタイミングで自動でスタイルチェックチェックが走ります\n- (修正が発生した場合) 修正後コミットする度にスタイルチェックが走ります\n\n### セットアップガイド\n\n1. [lint-unity-cs-pull-request.yaml](https://github.com/IShix-g/Unity-GitHubActions/blob/main/.github/workflows/lint-unity-cs-pull-request.yaml)からコードをコピーし、プロジェクトの `.github/workflows`フォルダに YAML ファイルを作成\n2. `branches`にブランチを指定 (例: 'main')\n3. `paths`に対象を指定、複数指定可 (例: `Assets/**`)\n3. (オプション) スタイルチェックの対象を`include-paths`に[正規表現](https://www.gnu.org/software/grep/manual/)を使って指定。`,`区切りで複数指定可 (例: `Assets/.*`)\n4. (オプション) スタイルチェックに含めたくないパスを`exclude-paths`に指定\n5. スタイルルールの設定ファイルを作成。[こちら](https://github.com/IShix-g/Unity-GitHubActions/blob/main/.editorconfig)を参考に[.editorconfig](https://learn.microsoft.com/visualstudio/ide/create-portable-custom-editor-options?view=vs-2022)を作成してください\n\n## 手動実行でスタイルチェック\n\n[lint-unity-cs-dispatch.yaml](https://github.com/IShix-g/Unity-GitHubActions/blob/main/.github/workflows/lint-unity-cs-dispatch.yaml)\n\n### 実行サンプル\n\n[https://github.com/IShix-g/Unity-GitHubActions/actions/runs/13626333298](https://github.com/IShix-g/Unity-GitHubActions/actions/runs/13626333298)\n\n\u003cimg src=\"dispatch_style_check.jpg\" width=\"500\"/\u003e\n\n### スタイルチェックの対象\n\n指定されたすべての`.cs`ファイルに対してスタイルチェックが走ります。\n\n### スタイルチェックの流れ\n\n`Run workflow`ボタンをクリックで実行します。\n\n\u003cimg src=\"dispatch_style_check2.jpg\" width=\"500\"/\u003e\n\n### セットアップガイド\n\n1. [lint-unity-cs-dispatch.yaml](https://github.com/IShix-g/Unity-GitHubActions/blob/main/.github/workflows/lint-unity-cs-dispatch.yaml)からコードをコピーし、プロジェクトの `.github/workflows`フォルダに YAML ファイルを作成\n2. (オプション) スタイルチェックの対象を`include-paths`に[正規表現](https://www.gnu.org/software/grep/manual/)を使って指定。`,`区切りで複数指定可 (例: `Assets/.*`)\n3. (オプション) スタイルチェックに含めたくないパスを`exclude-paths`に指定 \n4. スタイルルールの設定ファイルを作成。[こちら](https://github.com/IShix-g/Unity-GitHubActions/blob/main/.editorconfig)を参考に[.editorconfig](https://learn.microsoft.com/visualstudio/ide/create-portable-custom-editor-options?view=vs-2022)を作成してください\n\n\n## タグの更新\n\n[update-major-tag-v1.yaml](https://github.com/IShix-g/Unity-GitHubActions/blob/main/.github/workflows/update-major-tag-v1.yaml)\n\n任意のタグを、任意のタグを持つコミットに移動します。例えば、1系バージョンの安定版として、`v1`タグをコミットにつけるなどの運用で使えます。\n\n| Option     | Description                   | Default | Example |\n|------------|-------------------------------|---------|---------|\n| tag        | 移動するタグ                        |         | v1      |\n| target-tag | 対象のタグ、空の場合最終のタグを持つコミットを対象とします |         | 1.1.0   |\n\n### ローカルでのタグ確認\n\nフェッチしても、移動したタグが更新されない可能性が高いです。その場合は、下記を実行してください。\n\n```shell\ngit fetch origin --tags --force\n```\n\n## Jobの説明\n\n主なJobを説明です。\n\n### タグの検証 (Validate Tag)\n\n[reusable-validate-tag.yaml](https://github.com/IShix-g/Unity-GitHubActions/blob/main/.github/workflows/reusable-validate-tag.yaml)\n\nこのアクションは、タグの形式が有効かどうかを検証し、数値のみで正規化されたタグ (`outputs.normalized-tag`) を返します。\n\n#### 入力値 (Inputs)\n\n| ID                       | 説明                                                                                 | デフォルト値 |\n|--------------------------|--------------------------------------------------------------------------------------|------------|\n| require-validation       | 無効または古いタグを禁止する場合は `true`。検証が失敗しても続行する場合は `false`。      | true       |\n| validate-semantic-versioning | タグ形式を [Semantic Versioning](https://semver.org) に基づいて検証するかどうか。    | true       |\n| tag                      | 検証対象のタグ (例: `1.0.0`)                                                           |            |\n\n#### 出力値 (Outputs)\n\n| ID               | 説明                                                             |\n|------------------|-----------------------------------------------------------------|\n| normalized-tag   | 正規化されたタグ (例: `v` プレフィックスなし)                      |\n| tag              | 入力されたタグと同じ値                                          |\n| validated        | タグが検証を通過したかを示す                                      |\n\n---\n\n### package.json の更新 (Update package.json)\n\n[reusable-update-packagejson.yaml](https://github.com/IShix-g/Unity-GitHubActions/blob/main/.github/workflows/reusable-update-packagejson.yaml)\n\nこのアクションは、`package.json` 内のバージョンを更新し、変更をコミットします。\n\n#### 入力値 (Inputs)\n\n| ID                        | 説明                                                                                | デフォルト値                      |\n|---------------------------|------------------------------------------------------------------------------------|----------------------------------|\n| file-path                 | 更新する`package.json` のパス。複数行のパスを指定可能で、サポートされるのは `package.json` のみです |                                   |\n| tag                       | 適用する Git タグ (例: `1.0.0`)                                                     |                                   |\n| dry-run                   | 実際に変更をプッシュせず、更新とコミットをシミュレートする場合は `true`                  |                                   |\n| require-validation        | タグ検証が通過必須なら `true`。検証が失敗しても続行する場合は `false`                  | true                              |\n| ref                       | 更新前にチェックアウトするブランチまたはタグ                                         |                                   |\n| commit-message-format     | `package.json` を更新する際のコミットメッセージのテンプレート。例: `Update package.json to {v}` | `Update package.json to {v}` |\n\n#### Secrets (機密情報)\n\nブランチまたはタグの保護に必要:\n\n| ID               | 説明                              |\n|-------------------|-----------------------------------|\n| BOT_APP_ID        | アプリケーション ID を指定する    |\n| BOT_PRIVATE_KEY   | アプリ用の秘密鍵を設定する        |\n\n#### 出力値 (Outputs)\n\n| ID               | 説明                                          |\n|------------------|----------------------------------------------|\n| normalized-tag   | 正規化されたタグ (`v` プレフィックスなしのタグ) |\n| sha              | `package.json` 更新後の Git コミット SHA     |\n| changed          | Git ブランチが変更または新規作成されたかどうか |\n\n---\n\n### マージとプッシュ (Merge and Push)\n\n[reusable-merge-and-push.yaml](https://github.com/IShix-g/Unity-GitHubActions/blob/main/.github/workflows/reusable-merge-and-push.yaml)\n\nこのアクションは、ブランチをマージして変更をプッシュします。\n\n#### 入力値 (Inputs)\n\n| ID              | 説明                                           | デフォルト値 |\n|-----------------|-----------------------------------------------|------------|\n| target-branch   | リポジトリからマージする対象のブランチ              |            |\n| push-branch     | 変更をプッシュする対象ブランチ                  |            |\n| commit-id       | リリースやタグ作成用のコミットID                |            |\n| dry-run         | 実際にコミットせずシミュレーションする場合は `true`    | false      |\n| fast-forward    | ファストフォワードマージを許可する場合は `true`      | false      |\n\n#### Secrets (機密情報)\n\nブランチまたはタグの保護に必要:\n\n| ID               | 説明                              |\n|-------------------|-----------------------------------|\n| BOT_APP_ID        | アプリケーション ID を指定する    |\n| BOT_PRIVATE_KEY   | アプリ用の秘密鍵を設定する        |\n\n#### 出力値 (Outputs)\n\n| ID               | 説明                                     |\n|------------------|-----------------------------------------|\n| sha              | マージ後の Git コミット SHA             |\n| merged           | ブランチが正常にマージされたかどうか      |\n\n---\n\n### リリースノート生成 (Release Notes Generator)\n\n[reusable-release-notes.yaml](https://github.com/IShix-g/Unity-GitHubActions/blob/main/.github/workflows/reusable-release-notes.yaml)\n\nこのアクションは、コミットメッセージに基づいてリリースノートを生成します。`fix:` または `feat:` で始まるメッセージがリリースノートに含まれます。\n\n#### 入力値 (Inputs)\n\n| ID                     | 説明                                                                             | デフォルト値           |\n|------------------------|---------------------------------------------------------------------------------|-----------------------|\n| from-tag               | 開始タグ (未設定の場合は最初のコミットがデフォルト)                               |                       |\n| to-tag                 | 終了タグ (未設定の場合は最新コミットがデフォルト)                                |                       |\n| commit-message-format  | コミットメッセージの形式 (詳細は [pretty-formats](https://git-scm.com/docs/pretty-formats) を参照)。 | `- %s (%h)`           |\n| commit-id              | リリースやタグ作成用のコミット ID                                               |                       |\n| derive-from-tag        | 前回のタグを基に`from-tag`を自動決定する場合は `true`。手動設定の場合は `false`      | true                  |\n\n#### 出力値 (Outputs)\n\n| ID      | 説明                             |\n|---------|---------------------------------|\n| notes   | 生成されたリリースノート         |\n\n---\n\n### リリース作成 (Create Release)\n\n[reusable-create-release.yaml](https://github.com/IShix-g/Unity-GitHubActions/blob/main/.github/workflows/reusable-create-release.yaml)\n\nこのアクションは、リリースを作成し、必要に応じてタグを追加します。\n\n#### 入力値 (Inputs)\n\n| ID                     | 説明                                                                         | デフォルト値      |\n|------------------------|-----------------------------------------------------------------------------|-----------------|\n| commit-id              | リリースおよびタグ作成用のコミット ID                                        |                 |\n| dry-run                | シミュレーションのみにする場合は `true` (リリースは作成されません)                  |                 |\n| require-validation     | 検証が必須の場合は `true`、スキップする場合は `false`                          | true            |\n| wait-before-delete     | 一時的なブランチを削除する前の待機時間 (秒単位)                                  | 25              |\n| tag                    | 作成する Git タグ (例: `1.0.0`)                                              |                 |\n| release-format         | リリースタイトルのテンプレート (例: `Ver.{0}` は `Ver.1.0.0` のように設定されます)  | Ver.{0}         |\n| release-note           | 含めたいカスタムリリースノート                                              |                 |\n| draft-release          | 下書きリリースの場合は `true`、最終リリースの場合は `false`                      | false           |\n\n#### Secrets (機密情報)\n\nブランチまたはタグの保護に必要:\n\n| ID               | 説明                              |\n|-------------------|-----------------------------------|\n| BOT_APP_ID        | アプリケーション ID を指定する    |\n| BOT_PRIVATE_KEY   | アプリ用の秘密鍵を設定する        |\n\n---\n\n### Unityテストの実行 (Unity Test Framework)\n\n[reusable-unity-test.yaml](https://github.com/IShix-g/Unity-GitHubActions/blob/main/.github/workflows/reusable-unity-test.yaml)\n\n#### このWorkflowについて\n\n- Unity Editor上のEdit Test、Play Testのいずれかまたはすべてを実行します\n- [実行結果のサンプル](https://github.com/IShix-g/Unity-GitHubActions/actions/runs/13325816869)でテスト結果を確認できます\n- 利用には[設定](#test-framework-旧-test-runnerまたはパッケージを生成したい場合)が必要です\n\n※ GameCIの[Test Runner](https://game.ci/docs/github/test-runner)を利用してテストしています\n\n#### 入力値 (Inputs)\n\n| ID | 説明                                                                                | デフォルト値 |\n|---|-----------------------------------------------------------------------------------|--------|\n|unity-version | Unityのバージョンを指定、autoの場合プロジェクトのUnityバージョンを使う                                        | auto   |\n|project-path | Unityプロジェクトのパスを指定 |        |\n|test-modes | [どのテスト](https://game.ci/docs/github/test-runner/#testmode)を実行するかを指定               | playmode,editmode       |\n|coverage-options | [コード・カバレッジを設定](https://game.ci/docs/github/test-runner#coverageoptions)するためのオプション | generateAdditionalMetrics;generateHtmlReport;generateBadgeReport |\n\nUnityEditorの対応バージョンは[こちら](https://game.ci/docs/docker/versions)から確認できます。\n\n#### Secrets (機密情報)\n\nUnity Editorをバッチモードで起動する為に必要:\n\n| ID   | 説明  |\n|----|----|\n| UNITY_EMAIL    | UnityにログインするE-mail  |\n| UNITY_PASSWORD | Unityにログインするパスワード   |\n| UNITY_LICENSE  | ライセンスがPersonalの場合必要 |\n| UNITY_SERIAL   | ライセンスがProの場合必要      |\n\n詳しくは、[こちら](#test-framework-旧-test-runnerまたはパッケージを生成したい場合)を確認\n\n---\n\n### パッケージの生成 (Build Package)\n\n[reusable-build-package.yaml](https://github.com/IShix-g/Unity-GitHubActions/blob/main/.github/workflows/reusable-build-package.yaml)\n\n- パッケージのビルドを実行します\n- パッケージは`Assets`配下に設置している必要があります\n- [PackageExporter](#packageexporter)のインストールが必要です\n- 利用には[設定](#test-framework-旧-test-runnerまたはパッケージを生成したい場合)が必要です\n\n※ GameCIの[Builder](https://game.ci/docs/github/builder)を利用してパッケージを生成しています\n\n#### 入力値 (Inputs)\n\n| ID   | 説明                                         | デフォルト値                                  |\n|------|--------------------------------------------|-----------------------------------------|\n| tag  | 適用する Git タグ (例: `1.0.0`)                   |                                         |\n|package-name| パッケージ名を拡張子無しで指定 (例: `TestPackage`)         |                                         |\n|commit-id | リリースやタグ作成用のコミットID                          |                                         |\n|unity-version | Unityのバージョンを指定、autoの場合プロジェクトのUnityバージョンを使う | auto                                    |\n|project-path | Unityプロジェクトのパスを指定                          |                                         |\n|build-method | パッケージをビルドするスクリプトのメソッド名を`namespace`から指定     | PackageExporter.Editor.CLIBuilder.Build |\n|retention-days| [artifactに保存する期間](https://github.com/actions/upload-artifact?tab=readme-ov-file#usage)                        | 0                                       |\n\nUnityEditorの対応バージョンは[こちら](https://game.ci/docs/docker/versions)から確認できます。  \n生成したパッケージをリリースページにアップロードする場合は、`retention-days`は1日で良いです。\n\n#### 出力値 (Outputs)\n\n| ID           | 説明                     |\n|--------------|------------------------|\n| package-name | 指定したパッケージ名             |\n| export-path  | 生成されたパッケージの出力パス        |\n| artifact-url | 生成されたパッケージのダウンロードURL   |\n| package-hash | 生成されたパッケージのSHA-256ハッシュ |\n\n※ export-pathは確認用です。GitHub Actionsの特性上、Workflow終了後に削除されます。\n\n#### Secrets (機密情報)\n\nUnity Editorをバッチモードで起動する為に必要:\n\n| ID   | 説明  |\n|----|----|\n| UNITY_EMAIL    | UnityにログインするE-mail  |\n| UNITY_PASSWORD | Unityにログインするパスワード   |\n| UNITY_LICENSE  | ライセンスがPersonalの場合必要 |\n| UNITY_SERIAL   | ライセンスがProの場合必要      |\n\n詳しくは、[こちら](#test-framework-旧-test-runnerまたはパッケージを生成したい場合)を確認\n\n---\n\n### パッケージのアップロード (Upload package to release)\n\n[reusable-release-package-upload.yaml](https://github.com/IShix-g/Unity-GitHubActions/blob/main/.github/workflows/reusable-release-package-upload.yaml)\n\nこのアクションは、リリースページにパッケージをアップロードします。\n\n#### 入力値 (Inputs)\n\n| ID | 説明                                                               | デフォルト値 |\n|---|------------------------------------------------------------------|--------|\n|release-tag | アップロード対象のリリースのタグ (例: `1.0.0`)                                    |        |\n|artifact-package-name | アーティファクトにアップロードしたパッケージ名を指定 (例: `TestPackage_1.0.0.unitypackage`) |        |\n|package-hash | 対象パッケージのSHA-256ハッシュ                                              |        |\n|dry-run | テスト trueの場合、実際にはアップロードされません。                                     | false  |\n\n##### SHA-256ハッシュの生成\n\n自身で生成する場合は、下記のように生成します。  \nアーティファクトのアップロードで取得できる[artifact-digest](https://github.com/actions/upload-artifact#outputs)はSHA-256のハッシュですが流用できません。\n\n```yaml\nhash=$(sha256sum \"$package_path\" | awk '{ print $1 }')\n```\n\n---\n\n### C#ファイルのスタイルチェック (Lint C# Files for Unity)\n\n[reusable-lint-cs-files.yaml](https://github.com/IShix-g/Unity-GitHubActions/blob/main/.github/workflows/reusable-lint-cs-files.yaml)\n\n渡されたファイルに対してスタイルチェックを実行します。\n\n#### 使用しているOSS\n\n- [dotnet format](https://learn.microsoft.com/ja-jp/dotnet/core/tools/dotnet-format) スタイルチェックで使用\n- [StyleCop.Analyzers](https://github.com/DotNetAnalyzers/StyleCopAnalyzers) スタイルチェックで使用\n- [reviewdog](https://github.com/reviewdog/reviewdog) プルリクエストへのメッセージ表示など\n\n#### 入力値 (Inputs)\n\n| ID  | 説明                                                                                                                                  | デフォルト値              |\n|-----|-------------------------------------------------------------------------------------------------------------------------------------|---------------------|\n| ref | ブランチまたはコミットIDを指定                                                                                                                    | 未指定の場合、デフォルトブランチを使用 |\n| editorconfig-branch   | .editorconfigファイルのあるブランチを指定                                                                                                         | 未指定の場合、`ref`を使用     |\n| files   | 対象ファイルをAssetsからカンマ区切りで指定                                                                                                            |                     |\n| review-reporter   | [reviewdogのreporter](https://github.com/reviewdog/reviewdog?tab=readme-ov-file#reporters) を指定                                       | github-pr-review    |\n| review-level   | [reviewdogのlevel](https://github.com/reviewdog/reviewdog?tab=readme-ov-file#reporter-github-pr-checks--reportergithub-pr-check) を指定 | warning             |\n| review-exit-code   | [reviewdogのexit code](https://github.com/reviewdog/reviewdog?tab=readme-ov-file#exit-codes) を指定                                     | error               |\n\n---\n\n### メジャータグの更新 (Update Major Tag)\n\n[reusable-update-major-tag.yaml](https://github.com/IShix-g/Unity-GitHubActions/blob/main/.github/workflows/reusable-update-major-tag.yaml)\n\nこのアクションは、存在するタグを対象のタグを持つコミットに移動させます。\n\n#### 入力値 (Inputs)\n\n| ID        | 説明                                | デフォルト値      |\n|-----------|-----------------------------------|-----------------|\n| branch | リリースおよびタグ作成用のコミット ID              |                 |\n| tag | 移動対象のタグ (例: `v1`)                 |                 |\n| target-tag | 対象のタグを持つコミット。空の場合、最終コミットが対象となります。 |                 |\n\n#### 自動でタグを更新\n\nメジャータグの更新を忘れる事もあるので指定時間に確認して更新されていなければ更新するアクションです。\n\n[major_tag_automation-v1.yaml](https://github.com/IShix-g/Unity-GitHubActions/blob/main/.github/workflows/major_tag_automation-v1.yaml)\n\n最後に実行したリリースのWorkflowが、リリース日の範囲内であればタグを更新します。\n\n| ID        | 説明            | 例                            |\n|-----------|---------------|------------------------------|\n| cron | 何時に確認するか？     | 0 0 * * *            |\n| min-day | 対象のリリース日 - 最小 | 1                            |\n| max-day | 対象のリリース日 - 最大 | 2                            |\n| workflow_id | リリースのworkflow | - 'build-release_merge.yaml' |\n\n#### Secrets (機密情報)\n\nブランチまたはタグの保護に必要:\n\n| ID               | 説明                              |\n|-------------------|-----------------------------------|\n| BOT_APP_ID        | アプリケーション ID を指定する    |\n| BOT_PRIVATE_KEY   | アプリ用の秘密鍵を設定する        |\n\n#### ローカルでのタグ確認\n\nフェッチしても、移動したタグが更新されない可能性が高いです。その場合は、下記を実行してください。\n\n```shell\ngit fetch origin --tags --force\n```\n\n## GitHub Actionsの使用料について\n\nGitHub Actionsをprivateリポジトリで使う場合、使用料が発生します。publicリポジトリの場合は無料です。  \n使用料が発生しますが無料分が存在します。詳しくは、[Billing and plans \u003e Plans and usage \u003e Usage this month](https://github.com/settings/billing/summary)から確認できます。\n\n\n## 参考リポジトリ\n\n以下のリポジトリを参考にしました。\n\n[https://github.com/Cysharp/Actions](https://github.com/Cysharp/Actions)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fishix-g%2Funity-githubactions","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fishix-g%2Funity-githubactions","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fishix-g%2Funity-githubactions/lists"}