---
title: Unity 7が来る前に：CoreCLR 移行の仕組みと実践
tags: 
author: [Unity Technologies Japan](https://www.docswell.com/user/UnityJapan)
site: [Docswell](https://www.docswell.com/)
thumbnail: https://bcdn.docswell.com/page/47M6VM99JW.jpg?width=480
description: Unity 7が来る前に：CoreCLR 移行の仕組みと実践 by Unity Technologies Japan
published: November 18, 26
canonical: https://www.docswell.com/s/UnityJapan/5Q2WJW-2026-11-18-141452
---
# Page. 1

![Page Image](https://bcdn.docswell.com/page/47M6VM99JW.jpg)

本資料に関する注意事項
本資料は、⼀般的な情報提供⽬的で作成されたものであり、本資料に記載した
いかなる内容も、契約内容を構成するものではありません。
いかなる購買決定も、本資料に基づいてされることのないようにご注意ください。
本資料に記載したいかなる機能、コード、サービス内容についても、提供をお約束す
るものではありません。
本資料に記載した製品、サービス、機能の開発およびリリース時期については、Unity
の判断により決定され、変更の可能性があります。


# Page. 2

![Page Image](https://bcdn.docswell.com/page/P7RP2VG9J9.jpg)



# Page. 3

![Page Image](https://bcdn.docswell.com/page/PJX3DZX37X.jpg)

Unity 7が来る前に：
CoreCLR移⾏の仕組みと実践


# Page. 4

![Page Image](https://bcdn.docswell.com/page/3JKYX8WN7D.jpg)

Akiko Kawai
Senior Software Engineer
Unity Studio Productions, Engine Product


# Page. 5

![Page Image](https://bcdn.docswell.com/page/LE39521ZE5.jpg)

Unity Studio Productions とは
→ Unity社内のゲーム開発チーム
⎯ Engineer, Technical Artist, Technical Program Manager
Game Studio
Unity Studio
Productions
Unity Engine
1. ゲーム開発者の視点でエンジンを改善する
2. ゲームスタジオと共にゲームを作る
Stockholm
Vancouver
Seattle
Calgary
Montreal
San Francisco
Burbank
Austin
‒ 開発/ 移植/ 最適化/ 社内デモ&amp;ゲーム開発
i. サバイバルキッズ (開発), DREDGE (Android最適化)
Phasmophobia (コンソール移植)
London
Brighton
Copenhagen
Berlin
Seoul
Tokyo


# Page. 6

![Page Image](https://bcdn.docswell.com/page/8EDGDZX4EG.jpg)

Unityのバージョンアップ作業
→ 変更点を知ることで移⾏がスムーズに！
Unity 6→7では…
→ InstanceID の仕様変更
→ BIRP から URP へ
→ MonoからCoreCLRへの完全移⾏
他にも⾊々
はじめに
どんな良いことがあるのか？
変更時に想定される作業は何か？


# Page. 7

![Page Image](https://bcdn.docswell.com/page/V7P3XDPVJ8.jpg)

Unity 6 から Unity 7 へ
Unity 7 へは上げる価値があります
準備は Unity 6 の段階から始められます
変わること
→ MonoからCoreCLRへ！モダン.NETの恩恵を受けられる
→ 開発イテレーションが速くなる
今からどう準備する？
→ staticに頼ったコードの整理
→ 機能やパッケージの世代交代


# Page. 8

![Page Image](https://bcdn.docswell.com/page/2JV4L12R7Q.jpg)

アジェンダ
1. Unity 7 までの軌跡
a. プロローグ: The Story of .NET Runtime
2. Unity Editor の システム構成
a. Unity 6 までの Editor 〜Domain Reload〜
b. Unity 7からのEditor 〜AssemblyLoadContext〜
3. 安全な初期化 Lifecycle APIの登場
a. 初期化の流れ
4. アップグレード
a. Unity バージョンの確認
b. 計測
5. まとめ


# Page. 9

![Page Image](https://bcdn.docswell.com/page/5EG1X2R6JL.jpg)

1. Unity 7 までの軌跡


# Page. 10

![Page Image](https://bcdn.docswell.com/page/4JQD8PV27P.jpg)

プロローグ:
The Story of .NET Runtime


# Page. 11

![Page Image](https://bcdn.docswell.com/page/K74Z2YMPE1.jpg)

.NET Framework から .NET 10 まで
.NET
Framework
2000-2013
2014-2016
2017-2026
Windows専⽤
.NETが2つに
CoreCLRへ
.NET Core 1.0
/ AppDomain 1つ
.NET Core 3.0
/ALCアンロード可能
.NET 5で統合
→ .NET 10
IL2CPP登場
Unityも
.NET 10/CoreCLRへ
.NET
.NET Framework
1.0 (C#1.0)
/複数AppDomain
Mono
Mono 1.0
Unity
Unity 1.0
Mono組み込み


# Page. 12

![Page Image](https://bcdn.docswell.com/page/LJ1RM68XJG.jpg)

環境まとめ
Unity
Editor
Standalone
(Desktop)
Player
公開
API
6.7LTS
Unity 7
Mono(JIT)
+ Mono BCL
Mono(JIT)
+ Mono BCL
CoreCLR(RyuJIT)
+ .NET 10 BCL
Mono(JIT)
+ Mono BCL OR
Mono(JIT)
+ Mono BCL OR
IL2CPP
(Mono BCL)
IL2CPP
(Mono BCL)
Experimental
CoreCLR(RyuJIT)
+ .NET 10 BCL
CoreCLR(RyuJIT)
+ .NET 10 BCL
.NET Standard 2.1
.NET Standard 2.1
→.NET 10 / C#14 (予定)
6.6
.NET Standard 2.1
OR
Boehm GC
IL2CPP
(.NET10 BCL)
OR


# Page. 13

![Page Image](https://bcdn.docswell.com/page/GJW13WZKE2.jpg)

2. Unity Editor の
システム構成


# Page. 14

![Page Image](https://bcdn.docswell.com/page/4EZPV51NJ3.jpg)

Unity 6 までの Editor
〜Domain Reload〜


# Page. 15

![Page Image](https://bcdn.docswell.com/page/Y76M59L9EV.jpg)

Unity 6 までのUnity Editor
Unity Editorで作業しながらゲーム画⾯を確認する
Unity Editorの中で何が起きているんでしょうか？
まずは Unity 6 世代までの動きを⾒てみましょう


# Page. 16

![Page Image](https://bcdn.docswell.com/page/G75ZYN1DJ4.jpg)

Unity 6 までのUnity Editor - 2つのDomain構成
https://docs.unity3d.com/6000.6/Documentation/Manual/domain-reloading.html
Unity.exe / Unity.app
Unity Engine Process (C++)
Host
⚙ Native
Unity.dll - MonoManager
♻ Managed (Mono Runtime)
mono-2.0-bdwgc.dll/libmonobdwgc-2.0.dylib
Guest
UnityはC++をホストにして
C#の世界が動いています


# Page. 17

![Page Image](https://bcdn.docswell.com/page/9J2RG59M7R.jpg)

Unity 6 までのUnity Editor - 2つのDomain構成
https://docs.unity3d.com/6000.6/Documentation/Manual/domain-reloading.html
Unity.exe / Unity.app
Unity Engine Process (C++)
Host
⚙ Native
Unity.dll - MonoManager
♻ Managed (Mono Runtime)
mono-2.0-bdwgc.dll/libmonobdwgc-2.0.dylib
(1) Root Domain (常駐領域‧アンロード不可)
(2) Unity Child Domain (破棄可能な領域)
(a) Unity Engine
(b) Unity Editor
(c) 導⼊Package DLL
Guest
中には2つの
App Domain
(d) User C# Code(*.cs)
(e) 外部DLL


# Page. 18

![Page Image](https://bcdn.docswell.com/page/DEYDVK4PEM.jpg)

Unity 6 までのUnity Editorでの作業
Unity Child Domainの更新タイミングは？
Unity Child Domain
(a) Unity Engine
(b) Unity Editor
(c) 導⼊Package DLL
(d) User C# Code
(e) 外部DLL
もしかして
更新したいのは
これくらいでは?
Editorでシンボル定義を追加した
→ (c) (d)
User csファイルを更新した
→ (d)
サードパーティDLLをアップグレードした → (e)


# Page. 19

![Page Image](https://bcdn.docswell.com/page/VJN6MRYMJ8.jpg)

Unity 6 までのUnity Editorでの作業
Unity Child Domainの更新タイミングは？
Unity Child Domain
(a) Unity Engine
(b) Unity Editor
(c) 導⼊Package DLL
(d) User C# Code
(e) 外部DLL
(a) (b) の更新可能性ゼロ
エンジン本体を更新しない
エディターはそもそも起動中
もしかして
更新したいのは
これくらいでは?
Editorでシンボル定義を追加した
→ (c) (d)
User csファイルを更新した
→ (d)
サードパーティDLLをアップグレードした → (e)


# Page. 20

![Page Image](https://bcdn.docswell.com/page/YE9LNMPW73.jpg)

Unity 6 までのUnity Editorでの作業
Unity.exe / Unity.app
Unity Engine Process (C++)
Host
⚙ Native
Unity.dll - MonoManager
♻ Managed (Mono Runtime)
mono-2.0-bdwgc.dll/libmonobdwgc-2.0.dylib
(1) Root Domain (常駐領域‧アンロード不可)
Guest
アンロードでき
ないMono VM⽤
の⼟台
Unity Child
Domain
(a) Unity
Engine
(d) User
C# Code(*.cs)
(a) Unity
Engine
(d) User
C# Code(*.cs)
をアンロード
(b) Unity
Editor
(e) 外部DLL
(b) Unity
Editor
(e) 外部DLL
（強制破棄）
(c) 導⼊Package
(c) 導⼊Package
DLLDLL
→再度、新規⽣成
(2) Unity Child Domain (破棄可能な領域)


# Page. 21

![Page Image](https://bcdn.docswell.com/page/GE8XKLDRJD.jpg)

Unity 6 までのUnity Editorでの作業
Unity.exe / Unity.app
Unity Engine Process (C++)
Host
⚙ Native
Unity.dll - MonoManager
♻ Managed (Mono Runtime)
mono-2.0-bdwgc.dll/libmonobdwgc-2.0.dylib
(1) Root Domain (常駐領域‧アンロード不可)
ここも対象
Guest
アンロードでき
ないMono VM⽤
の⼟台
Unity Child
Domain
(a) Unity
Engine
(d) User
C# Code(*.cs)
(a) Unity
Engine
(d) User
C# Code(*.cs)
をアンロード
(b) Unity
Editor
(e) 外部DLL
(b) Unity
Editor
(e) 外部DLL
（強制破棄）
(c) 導⼊Package
(c) 導⼊Package
DLLDLL
→再度、新規⽣成
(2) Unity Child Domain (破棄可能な領域)


# Page. 22

![Page Image](https://bcdn.docswell.com/page/LEL8ZLM27R.jpg)

MonoManager が Root Domain の下に
Unity 6 までのUnity Editorでの作業
Unity Child Domain を1つ作り
Unity.exe / Unity.app
Domain Reloadで世代交代させる仕組み
Unity Engine Process (C++)
↓
Host
⚙ Native
Editor利⽤者はUnity Engineまで更新の必要は無い
Unity.dll - MonoManager
けど再ロードすることになる
Guest
↓
♻ Managed (Mono Runtime)
Domain Reloadで待たされる
mono-2.0-bdwgc.dll/libmonobdwgc-2.0.so
アンロードでき
ないMono VM⽤
(1) Root Domain (常駐領域‧アンロード不可)
ここも対象
の⼟台
Unity Child
Domain
(a) Unity
Engine
(d) User
C# Code(*.cs)
(a) Unity
Engine
(d) User
C# Code(*.cs)
をアンロード
(b) Unity
Editor
(e) 外部DLL
(b) Unity
Editor
(e) 外部DLL
（強制破棄）
(c) 導⼊Package
(c) 導⼊Package
DLLDLL
→再度、新規⽣成
(2) Unity Child Domain (破棄可能な領域)


# Page. 23

![Page Image](https://bcdn.docswell.com/page/4JM6VMY9EW.jpg)

App Domainを⼯夫してたら…?
Root DomainにEngineを置いたら良いのでは？
(1) Root Domain
BCL (mscorlib)
(a) Unity Engine
(b) Unity Editor
(2) Unity Child Domain
(c) 導⼊Package DLL
(e) 外部DLL
(3) Unity Child Domain
(d) User C# Code
頻繁に更新するユーザーコードだけ
別ドメインにしたら良いのでは？


# Page. 24

![Page Image](https://bcdn.docswell.com/page/PJRP2V99E9.jpg)

(仮定): もしRoot DomainにEngine本体を置いていたら…
Unity Engine Process (C++)
⚙ Native
Unity.dll - MonoManager
♻ Managed (Mono Runtime)
mono-2.0-bdwgc.dll/libmonobdwgc-2.0.dylib
コード更新時
(2)
Unity
Child
Domain
(1) Root Domain
にここだけ
(c)
導⼊Package
DLL
(常駐領域)
アンロード
(e) 外部DLL
(a) Unity Engine
(b) Unity Editor
(3) Unity Child Domain
(d) User C# Code
⼀⾒よさそう


# Page. 25

![Page Image](https://bcdn.docswell.com/page/PEX3DZQ3JX.jpg)

(仮定): もしRoot DomainにEngine本体を置いていたら…
別ドメインのオブジェクト
Unity Engine Process
(C++)
Gameでは無理
を直接参照できない
⚙ Native
(ドメイン越境が必要)
Unity.dll - MonoManager
Update()毎に
♻ Managed (Mono
Runtime)
マーシャリングする!?
mono-2.0-bdwgc.dll/libmonobdwgc-2.0.dylib
(1) Root Domain
(常駐領域)
(a) Unity Engine
(b) Unity Editor
(2) Unity Child Domain
(c) 導⼊Package DLL
(e) 外部DLL
(3) Unity Child Domain
(d) User C# Code


# Page. 26

![Page Image](https://bcdn.docswell.com/page/3EKYX89NJD.jpg)

(仮定): もしRoot DomainにEngine本体を置いていたら…
別の例：
Unity Engine Process (C++)
イベント登録
⚙ Native
Unity.dll - MonoManager
(例)
Editor側は
♻ Managed (Mono Runtime)
Editor側の static event にメソッドを登録した
ユーザー側の mono-2.0-bdwgc.dll/libmonobdwgc-2.0.so
EditorApplication.update
static を持つ
(2) Unity+=
Child
Domain
MyEditorUpdate;
(1) Root Domain
(c) 導⼊Package DLL
(常駐領域)
(e) 外部DLL
(a) Unity Engine
(b) Unity Editor
(3) Unity Child Domain
(d) User C# Code
そしてここが
アンロードさ
れたら?


# Page. 27

![Page Image](https://bcdn.docswell.com/page/L73952WZ75.jpg)

(仮定): もしRoot DomainにEngine本体を置いていたら…
別の例：
Unity Engine Process (C++)
イベント登録
⚙ Native
Unity.dll - MonoManager
(例)
Editor側は
♻ Managed (Mono Runtime)
Editor側の static event にメソッドを登録した
ユーザー側の mono-2.0-bdwgc.dll/libmonobdwgc-2.0.so
EditorApplication.update
static を持つ
(2) Unity+=
Child
Domain
MyEditorUpdate;
(1) Root Domain
(c) 導⼊Package DLL
(常駐領域)
(e) 外部DLL
アンロード対応
必須
(a) Unity Engine
そしてここが
(3) Unity Child Domain
(b) Unity Editor
アンロードさ
(d) User C# Code
古いstaticを
れたら?
持ち続ける🔥


# Page. 28

![Page Image](https://bcdn.docswell.com/page/87DGDZK47G.jpg)

Unity 6 までのUnity Editor - 2つのDomain構成
https://docs.unity3d.com/6000.6/Documentation/Manual/domain-reloading.html
Unity.exe / Unity.app
Unity Engine Process (C++)
Host
⚙ Native
Unity.dll - MonoManager
♻ Managed (Mono Runtime)
mono-2.0-bdwgc.dll/libmonobdwgc-2.0.dylib
(1) Root Domain (常駐領域‧アンロード不可)
(2) Unity Child Domain (破棄可能な領域)
Guest
Engine含めて
全部アンロード
する
（強制破棄）
(a) Unity
Engine
(d) User
C# Code(*.cs)
(a) Unity
Engine
(d) User
C# Code(*.cs)
C#の状態は消える
(b)
Unity
Editor
(e)
外部DLL
(b) Unity Editor
(e) 外部DLL
(Object や static 等)
(c)
導⼊Package
DLL
(c) 導⼊Package DLL


# Page. 29

![Page Image](https://bcdn.docswell.com/page/VJP3XDKVE8.jpg)

AppDomain リロードの流れ - Mono
https://docs.unity3d.com/ja/6000.0/Manual/conﬁgurable-enter-play-mode-details.html
AssemblyReloadEvents
.beforeAssemblyReload
リロード直前
.afterAssemblyReload
リロード直後
[InitializeOnLoad]
ドメインリロード時
⚙Native(C++)
シリアライズ対象フィールドのバック
アップ
退避データ
♻ Managed (Mono Runtime)
Child Domain Engine/Editor/*.cs
New Engine/Editor/*.cs
mscorlib 常駐
Root Domain
(1)
全破棄
(2) (3)
バックアップ
(4)
(5)
(6)(7)
Mono が
新 Child Domainをロード
(8)
(9)
(10)
リストア
時間軸


# Page. 30

![Page Image](https://bcdn.docswell.com/page/2EV4L1VRJQ.jpg)

Unity 6 までのUnity Editorまとめ
Unity 6まで：
Unity Engine ごと Unity Child Domain に⼊れ、
全部まとめて強制破棄する設計
確実だが、Engine まで再ロードの必要がある
CoreCLR ではどう解決するか？


# Page. 31

![Page Image](https://bcdn.docswell.com/page/57G1X2L6EL.jpg)

Unity 7からのEditor
〜AssemblyLoadContext〜


# Page. 32

![Page Image](https://bcdn.docswell.com/page/4EQD8PY2JP.jpg)

Unity 7 からのUnity Editor
Unity 7からはAppDomainではなく
AssemblyLoadContext (ALC)
という技術が使われています
どんな変化が起きているのか
メリットやデメリットは何か？
⾒ていきましょう！


# Page. 33

![Page Image](https://bcdn.docswell.com/page/KJ4Z2YWP71.jpg)

AssemblyLoadContextとは
https://learn.microsoft.com/ja-jp/dotnet/core/dependency-loading/understanding-assemblyloadcontext
ALC
→ アセンブリをグループ単位で読み込んだり
破棄したりするランタイム機能
→ 従来のMonoの AppDomain (ドメインリロード) に代わる
コードリロードの仕組み


# Page. 34

![Page Image](https://bcdn.docswell.com/page/LE1RM6YXEG.jpg)

Unity 6 までのUnity Editorでの作業
Unity Engine Process (C++)
⚙ Native
Unity.exe / Unity.app
AppDomain時代の
ページ再掲
Host
Unity.dll - MonoManager
Guest
♻ Managed (Mono Runtime)
mono-2.0-bdwgc.dll/libmonobdwgc-2.0.dylib
Engine含めて全部
(1) Root Domain (常駐領域‧アンロード不可) アンロードする
（強制破棄）
(2) Unity Child Domain (破棄可能な領域)
(a) Unity
Engine
(d) User
C# Code(*.cs)
(a) Unity
Engine
(d) User
C# Code(*.cs)
C#の状態は消える
(b)
Unity
Editor
(e)
外部DLL
(b) Unity Editor
(e) 外部DLL
(Object や static 等)
(c)
導⼊Package
DLL
(c) 導⼊Package DLL


# Page. 35

![Page Image](https://bcdn.docswell.com/page/GEW13WGK72.jpg)

Unity 7(開発中)時点の Editor
Unity.exe / Unity.app
Unity Engine Process (C++)
⚙ Native
CoreCLR Host
♻ Managed
Host
Guest
CoreCLR Runtime
(1) Default ALC (常駐領域‧アンロード不可)
.NET 10 BCL
(a) Unity Engine (b) Unity Editor
(2) User ALC (collectible‧アンロード可能)
(c) 導⼊Package DLL (d) User C# Code(*.cs)
(e) 外部DLL


# Page. 36

![Page Image](https://bcdn.docswell.com/page/47ZPV5LNE3.jpg)

ALCリークの例
https://learn.microsoft.com/en-us/dotnet/standard/assembly/unloadability
Unity.exe / Unity.app
Unity Engine Process (C++)
⚙ Native
Host
CoreCLR Host
♻ Managed
(1) Default ALC
Guest
CoreCLR Runtime
TimerQueue
(2) User ALC (collectible)
参照する!
このままでは
アンロードが
出来なくなる
static Timer _timer;
static void StartMyChecker() {
_timer = new Timer(OnMyTick, null, 0, 1000);
}


# Page. 37

![Page Image](https://bcdn.docswell.com/page/YJ6M59W97V.jpg)

ALCリークの例
https://learn.microsoft.com/en-us/dotnet/standard/assembly/unloadability
Unity.exe / Unity.app
Unity Engine Process (C++)
⚙ Native
CoreCLR Host
♻ Managed
(1) Default ALC
_timer.Dispose()を呼んで
TimerQueueから
Host
⾃分のデリゲートを
消す必要がある
Guest
CoreCLR Runtime
TimerQueue
(2) User ALC (collectible)
参照する!
このままでは
アンロードが
出来なくなる
static Timer _timer;
static void StartMyChecker() {
_timer = new Timer(OnMyTick, null, 0, 1000);
}


# Page. 38

![Page Image](https://bcdn.docswell.com/page/GJ5ZYNMDE4.jpg)

ALC リロードの流れ - CoreCLR （開発中ver)
https://docs.unity.com/en-us/engine/6000.6/manual/programming-environment/code-reload-serialization/code-reload/code-lifecycle
[OnCodeInitializing]
[OnCodeLoaded] リストア直後
ロード直後
回収待ち:
⚙Native(C++)
シリアライズ対象フィールドのバック
参照が 0本に
アップ
なってから
♻ Managed (CoreCLR Runtime)
*.cs
[OnCodeDeinitializing]
シリアライズ直前 [OnCodeUnloading]
アンロード直前通知
退避データ
User ALC (old)
User ALC (new)
New
Default ALC
.NET BCL/ Engine/ Editor 常駐
(1)
(2)
バックアップ
(3)
アンロード
要求
(4)
*.cs
(5)
時間軸
リストア


# Page. 39

![Page Image](https://bcdn.docswell.com/page/LE39529QE5.jpg)

AppDomainとALC
AppDomain
同⼀プロセス内で論理的に
分離された実⾏環境
メモリ空間
ドメイン超えでは
マーシャリングが必要
アンロード
設計⽬的
強制破棄
ALC
同じメモリ空間
直接参照OK
協調的アンロード
参照が残ると破棄しない
プロセス内の軽量プロセス
アセンブリ、ロードの分離
分離境界
ランタイムは
セキュリティ分離を意識した ロード/アンロードに徹する
設計思想


# Page. 40

![Page Image](https://bcdn.docswell.com/page/8EDGDZGWEG.jpg)

Unity 7 からのUnity Editorまとめ
Unity 7から：
Unity Engine と ユーザーコードを別のALCとし
User ALCの単位でロード/リロードをする
本来やりたかったローディングが可能に！
ローディングが変わることによって
何が必要になるのか？
static 問題にどうやって対応するのか？


# Page. 41

![Page Image](https://bcdn.docswell.com/page/V7P3XD3XJ8.jpg)

3. 安全な初期化
Lifecycle APIの登場


# Page. 42

![Page Image](https://bcdn.docswell.com/page/2JV4L1437Q.jpg)

Lifecycle APIとは
Lifecycle API (Unity 6.5〜)
コードの初期化と終了処理を確実に⾏うためのAPI群
CoreCLR時代→ドメインリロードなしの世界へ


# Page. 43

![Page Image](https://bcdn.docswell.com/page/5EG1X21YJL.jpg)

初期化の流れ


# Page. 44

![Page Image](https://bcdn.docswell.com/page/4JQD8PD67P.jpg)

AppDomain リロードの流れ - Mono
https://docs.unity3d.com/ja/6000.0/Manual/conﬁgurable-enter-play-mode-details.html
AssemblyReloadEvents
.beforeAssemblyReload
リロード直前
.afterAssemblyReload
リロード直後
[InitializeOnLoad]
ドメインリロード時
⚙Native(C++)
リロード⽤のAPIは
シリアライズされたバックアップ
書き⽅がバラバラ
退避データ
♻ Managed (Mono Runtime)
Child Domain Engine/Editor/*.cs
New Engine/Editor/*.cs
mscorlib 常駐
Root Domain
(1)
全破棄
(2) (3)
バックアップ
(4)
(5)
(6)(7)
Mono が
新 Child Domainをロード
(8)
(9)
(10)
リストア
時間軸


# Page. 45

![Page Image](https://bcdn.docswell.com/page/K74Z2YZME1.jpg)

Lifecycle APIとは
コードの初期化と終了処理を確実に⾏うための
2種類のフックと便利機能
1. コードリロード時のフック
‒ [OnCodeUnloading] など
2. Edit/Playモード遷移時のフック
（Fast Enter Play Mode対策）
‒ [OnEnteringPlayMode]など
‒ static を⾃動リセットする便利属性
‒ [AutoStaticsCleanup]


# Page. 46

![Page Image](https://bcdn.docswell.com/page/LJ1RM6RYJG.jpg)

Lifecycle API の (1) コードリロード時のフック
[OnCodeDeinitializing]
シリアライズ直前 [OnCodeUnloading]
アンロード直前通知
[OnCodeInitializing]
[OnCodeLoaded] リストア直後
ロード直後
⚙Native(C++)
シリアライズ対象フィールドのバック
アップ
退避データ
初期化と
リセットがペア
♻ Managed (CoreCLR Runtime)
*.cs
User ALC (old)
User ALC (new)
New
Default ALC
.NET BCL/ Engine/ Editor 常駐
(1)
(2)
バックアップ
(3)
アンロード
要求
(4)
*.cs
(5)
時間軸
リストア


# Page. 47

![Page Image](https://bcdn.docswell.com/page/GJW13W11E2.jpg)

Lifecycle API の (2) Edit/Playモード遷移時のフック
[OnExitingEditMode] [AutoStaticsCleanup] [OnEnteringEditMode]
が⾃動発動
Editモード開始
Editモード終了
[OnEnteringPlayMode] [OnExitingPlayMode]
Playモード終了
Playモード開始
前述のコードリロード区間
(ALCリロード対策)
1.
2.
3.
4.
[OnCodeDeinitializing]
[OnCodeUnloading]
[OnCodeLoaded]
[OnCodeInitializing]
コードリロード区間を
スキップする
Play
Mode
時間軸
ただし、Editor初回起動時/
コード変更時は必ず動く


# Page. 48

![Page Image](https://bcdn.docswell.com/page/4EZPV5PXJ3.jpg)

Lifecycle API対応 - static のリセット
→ コードリロードをスキップすると
‒ 待ち時間が短くなり、開発イテレーションが速くなる
‒ static の値が残るので、
⾃分でリセットする必要がある
Fast Enter Play Mode
計測例
画⾯表⽰までの
(6.7α)
所要時間
OFF
約 16 秒
ON
約6秒
https://cedec.cesa.or.jp/2026/timetable/detail/s69f30c7038364/


# Page. 49

![Page Image](https://bcdn.docswell.com/page/Y76M59MPEV.jpg)

Lifecycle API コードサンプル (6.7β)
親のclass/structには
using Unity.Scripting.LifecycleManagement; partialが必要
(Roslynでリセット⽤
[AutoStaticsCleanup]
public partial class Ocean: MonoBehaviour のコードを⾃動⽣成)
{
// 自動リセット: staticプロパティ
public static Ocean Instance{ get; private set; }
void Awake() =&gt; Instance = this;
// 影響なし: 普通のstaticメソッド（戻り値や引数は無関係）
public static int GetWaveLevel(float power){…}
public static void SetWave(float height){…}
// 自動実行: Lifecycle属性付きメソッド,引数なしのstatic voidが必要
[OnEnteringPlayMode] static void OnPlayStart(){…}
https://cedec.cesa.or.jp/2026/timetable/detail/s69f30c7038364/


# Page. 50

![Page Image](https://bcdn.docswell.com/page/G75ZYNZPJ4.jpg)

4. アップグレード


# Page. 51

![Page Image](https://bcdn.docswell.com/page/9J2RG5RZ7R.jpg)

Unityバージョンの確認


# Page. 52

![Page Image](https://bcdn.docswell.com/page/DEYDVKDNEM.jpg)

Unityバージョンと機能の変遷
Version
Scripting
Runtime
:Editor
Scripting
Backend
:Player JIT
Scripting
Backend
:Player AOT
(IL2CPP)
2022.3
LTS
6.0
LTS
6.1
6.2
6.3
LTS
6.4
6.5
6.6
6.7
LTS
7.0
��Core
CLR
Mono
Mono
6.7 Experimental
Mono BCL
Monoは6.7まで
CoreCLR
.NET
10
BCL


# Page. 53

![Page Image](https://bcdn.docswell.com/page/VJN6MR6VJ8.jpg)

Unityバージョンと機能の変遷
https://docs.unity.com/en-us/engine/6000.6/manual/whats-new/unity66
https://docs.unity3d.com/Packages/com.unity.inputsystem@7.0/manual/index.html
Version
2022.3
LTS
6.0
LTS
6.1
6.2
6.3
LTS
6.4
6.5
6.6
6.7
LTS
ライフサ
イクル
管理
AppDomain Domainリロード系 API ��
Lifecycle API
Domain
Reload
Default
Fast Enter Play Mode (OFF)
Project
Auditor
Project Auditor
Input
7.0
FEPM (ON)
Editor同梱
��
Input Manager
Input System Package
Editor同梱


# Page. 54

![Page Image](https://bcdn.docswell.com/page/YE9LNMLV73.jpg)

Unityバージョンと機能の変遷
https://docs.unity.com/en-us/engine/6000.5/manual/upgrade-guides/upgrade-guide-unity64
Version
Render
Pipeline
Render
Pass API
Object
ID
2022.3
LTS
6.0
LTS
6.1
6.2
6.3
LTS
6.4
6.5
6.6
��
Built-in Render Pipeline ⭐
Universal Render Pipeline (URP)
��
Legacy API ⭐
6.3 Editor
設定から削除
(Compatibility Mode)
Render Graph
InstanceID �� ⭐
EntityId
6.4から警告
6.7
LTS
7.0
BIRPは
ここまで


# Page. 55

![Page Image](https://bcdn.docswell.com/page/GE8XKLX4JD.jpg)

どのバージョンを経由？
Version
2022.3
LTS
6.0
LTS
6.1 6.2
6.3
LTS
6.4
6.5
6.6
Mono
AppDomain.DomainUnload
��
Built-in Render Pipeline
6.7
LTS
7.0
��
InstanceID ��
Input Manager��
本検証はUnityが社内で独⾃に⾏ったもので、実際のゲームや運営とは関係ありません
また「魔法使いと黒猫のウィズ」の今後のアップグレードを⽰すものではありません


# Page. 56

![Page Image](https://bcdn.docswell.com/page/LEL8ZL8V7R.jpg)

実践した
アップグレード内容の紹介
複数プロジェクトでの検証まとめ


# Page. 57

![Page Image](https://bcdn.docswell.com/page/4JM6VM6NEW.jpg)

Built-in Render Pipeline 対応
6.0 でURPへ
2022.3 → 6.0 にアップグレード
2022.3 までにURPにしていない：
→ Compatibility Mode が OFF となりRender Graph が有効状態
2022.3 までにURPにしている場合：
→ Compatibility Mode が ON
‒ 6.3で設定 UI から削除される
→ 6.0（〜6.2）のうちに OFF にするのがおすすめ
これで 6.3 へ


# Page. 58

![Page Image](https://bcdn.docswell.com/page/PJRP2VP4E9.jpg)

InstanceID 対応
6.3 でEntityIdへ
InstanceID は EntityId (6.2〜) へ変更する必要がある
→ GetInstanceID() →GetEntityId()
→ 6.4 で⾮推奨（警告）、6.5 でエラー（使⽤不可）
これで 6.5 へ


# Page. 59

![Page Image](https://bcdn.docswell.com/page/PEX3DZ3ZJX.jpg)

Input Manager 対応（必須ではない）
6.5 でInput Systemへ
Input System が6.7 でコアパッケージとなる
→ 将来を⾒据えて、置き換え実施
これで 6.7 へ


# Page. 60

![Page Image](https://bcdn.docswell.com/page/3EKYX8YVJD.jpg)

Project Auditor をつかう
6.7 でLifecycle API対応
をしたい
検証では Unity 6.7 で Project Auditor を実施
Unity 6.7にアップグレードしただけでは、
static変数のリセット漏れはエラー/警告にならない
6.6以前では
Use Roslyn Analyzers
にチェック
( 6.7では不要 )


# Page. 61

![Page Image](https://bcdn.docswell.com/page/L73952VQ75.jpg)

Project Auditor をつかう
6.7 でLifecycle API対応
をしたい
Lifecycle APIの対応だけを知りたい場合
調査対象を Code に絞ると、チェックが数分で済む
この調査結果に対応していく


# Page. 62

![Page Image](https://bcdn.docswell.com/page/87DGDZ8W7G.jpg)

Lifecycle API対応 (1)
Project Auditorで検出した個所を修正していく
class/struct内で static プロパティなどを利⽤している個所に対しては
ほぼこれ
using Unity.Scripting.LifecycleManagement;
[AutoStaticsCleanup]
public partial class ScoreManager { … }
→ static コンストラクタでの初期化、readonly フィールドは
別途対応が必要
※コードは説明⽤に作成したサンプルです


# Page. 63

![Page Image](https://bcdn.docswell.com/page/VJP3XD8XE8.jpg)

Lifecycle API対応 (2)
Property⽤途（static コンストラクタで利⽤しているもの）
→ クラスに [NoAutoStaticsCleanup]をつける
コンストラクタの initialise()が APP_VERSION などを決めてる所
static なので…とリセットすると、コンストラクタは再実⾏されない
[NoAutoStaticsCleanup]
public static class Property {
static Property (){
initialise();
}
static void initialise(){...}
※コードは説明⽤に作成したサンプルです


# Page. 64

![Page Image](https://bcdn.docswell.com/page/2EV4L1N3JQ.jpg)

利⽤内容をよく
⾒て対応が必要
Lifecycle API対応 (3)
もともと [InitializeOnLoad] をつけている個所
FEPM ONでは再実⾏はされない（設定済みの状態が残る）
このclass全体に [AutoStaticsCleanup] をつけてしまうと
2回⽬以降の Play で設定されなくなってしまう
[OnEnteringEditMode]
[OnExitingEditMode]
[AutoStaticsCleanup]
Editモード開始
Editモード終了 [OnEnteringPlayMode] [OnExitingPlayMode]
Playモード開始
コードリロード区間を
スキップする
[InitializeOnLoad]
旧Domain Reload時
Playモード終了
Play
Mode
時間軸
[NoAutoStaticsCleanup]にする?
別の場所に移動する?


# Page. 65

![Page Image](https://bcdn.docswell.com/page/57G1X2KYEL.jpg)

利⽤内容をよく
⾒て対応が必要
Lifecycle API対応 (4)
static readonly は基本は何もしなくていい（リセット不要）
しかし、クラス全体に[AutoStaticsCleanup]がついてる場合
[NoAutoStaticsCleanup]つけないと⽭盾が発⽣する
[AutoStaticsCleanup]
public partial class SaveData {
[NoAutoStaticsCleanup]
public static readonly MyData LocalData = new MyData();
}
※コードは説明⽤に作成したサンプルです
このあたりまで来るとstaticの扱い⽅の
パターンが⾒えてくる


# Page. 66

![Page Image](https://bcdn.docswell.com/page/4EQD8PN6JP.jpg)

Fast Enter Play Mode (ON) の設定
Reload Scene only


# Page. 67

![Page Image](https://bcdn.docswell.com/page/KJ4Z2YGM71.jpg)

InstanceID 対応
その他プロジェクト
プロジェクト内のコード
→
⽐較的容易
外部パッケージ
→
連鎖的にバージョンアップが発⽣
(例)
古いバージョンに固定し独⾃改修したパッケージ(Addressables等)
→ 依存パッケージ(UI Toolkit 等)も古いまま
→ 古い API 削除対応や EntityId 対応まで⼿作業に
→ カスタマイズ機能をあきらめて公式版利⽤へ


# Page. 68

![Page Image](https://bcdn.docswell.com/page/LE1RM6DYEG.jpg)

計測


# Page. 69

![Page Image](https://bcdn.docswell.com/page/GEW13WY172.jpg)

Fast Enter Play Mode demo
本検証はUnityが社内で独⾃に⾏ったもので、実際のゲームや運営とは関係ありません
また「魔法使いと黒猫のウィズ」の今後のアップグレードを⽰すものではありません


# Page. 70

![Page Image](https://bcdn.docswell.com/page/47ZPV5XXE3.jpg)

Fast Enter Play Mode (OFF) Reload Domain and Scene
本検証はUnityが社内で独⾃に⾏ったもので、実際のゲームや運営とは関係ありません
また「魔法使いと黒猫のウィズ」の今後のアップグレードを⽰すものではありません


# Page. 71

![Page Image](https://bcdn.docswell.com/page/YJ6M594P7V.jpg)

Fast Enter Play Mode (ON) Reload Scene only
本検証はUnityが社内で独⾃に⾏ったもので、実際のゲームや運営とは関係ありません
また「魔法使いと黒猫のウィズ」の今後のアップグレードを⽰すものではありません


# Page. 72

![Page Image](https://bcdn.docswell.com/page/GJ5ZYNQPE4.jpg)

Fast Enter Play Mode ⽐較 - Unity 6.7 β7 (Editor)
Fast Enter Play Mode (6.7β)
Domain
読み込み
画⾯表⽰までの
時間
OFF
(Reload Domain and Scene)
約7秒
約 16 秒
ON
(Reload Scene only)
なし
約3秒
本検証はUnityが社内で独⾃に⾏ったもので、実際のゲームや運営とは関係ありません
また「魔法使いと黒猫のウィズ」の今後のアップグレードを⽰すものではありません


# Page. 73

![Page Image](https://bcdn.docswell.com/page/9E2RG5PZJR.jpg)

Unity 7.0α 計測 - サンプルプロジェクト


# Page. 74

![Page Image](https://bcdn.docswell.com/page/D7YDVK5N7M.jpg)

Unity 7.0α 計測 - サンプルプロジェクト
花⽕のデモ
→ 打ち上げ続けて、短命なオブジェクトを⼤量に作り続ける
→ 2万〜2.5万 粒くらいの花⽕
C#スクリプトのみで
→ 花⽕1粒 = C#のclass (毎回 new)
→ 花⽕の軌跡の位置
= 花⽕ごとに配列を new
→ 消えた花⽕は LINQ (Where-&gt;ToList) で毎フレーム削除
ECS, Jobs, Burst, ⾃作のShader, Particle Systemなど未使⽤


# Page. 75

![Page Image](https://bcdn.docswell.com/page/VEN6MRNVE8.jpg)

花⽕プロジェクト計測結果 - Unity 7.0α16 (Editor)
花⽕プロジェクトを Unity 6.7β、7.0αで⽐較
⾚ = 60fpsに間に合ってない箇所
6.7β
7.0α
6.7β
7.0αのほうが16ms付近でなだらか
7.0α


# Page. 76

![Page Image](https://bcdn.docswell.com/page/Y79LNMRVJ3.jpg)

花⽕プロジェクト計測結果 - Unity 7.0α16 (Editor)
Memory傾向
6.7β
7.0α
メモリ確保量は同じだが、7.0αは⼩さい単位でGCを実施と予想


# Page. 77

![Page Image](https://bcdn.docswell.com/page/G78XKLW4ED.jpg)

花⽕プロジェクト計測結果 - Unity 7.0α16 (Editor)
CPU
中央値
C# Script
中央値
6.7β
22.2 ms
15.08 ms
7.0α
11.3 ms
5.07 ms
約2倍速
約3倍速
純粋なC# Script部分が⾼速化
あくまで
new によるメモリ確保の
多いスクリプトでの
計測結果


# Page. 78

![Page Image](https://bcdn.docswell.com/page/L7L8ZLNVJR.jpg)

5. まとめ


# Page. 79

![Page Image](https://bcdn.docswell.com/page/4EM6VMXN7W.jpg)

まとめ
Unity 7 で Mono から CoreCLR へ
変わること
→ MonoからCoreCLRへ！モダン.NETの恩恵を受けられる
→ 開発イテレーションが速くなる
→ static の扱い⽅が明確になり、コードの品質が上がる
今からどう準備する？
→ staticに頼ったコードの整理
‒ 「⾃動で初期化」から「⾃分で管理」へ
→ Unity 6 のうちに機能やパッケージの世代交代


# Page. 80

![Page Image](https://bcdn.docswell.com/page/PERP2VN479.jpg)

Thank you


