CAFU v3 完全に理解した / Updates for CAFU v3

2018/10/02 (Tue) に開催した、キッズスター開発合宿 vol.6 での資料です。
CAFU: Clean Architecture for Unity の v3 に関するアップデート情報などを軸に Zenject についても解説しています。

スクリーンキャプチャ動画も撮影しているので以下にリンクします。

- [Changes](https://youtu.be/snavhGhm6cc)
- [Zenject](https://youtu.be/mO2BN6foSMg)
- [処理の流れ](https://youtu.be/B4_wlM3KEXs)
- [v2 と v3 の移行・共存](https://youtu.be/w_RNPdJVJ3w)

Transcript

1. גࣜձࣾΩοζελʔ CTO ৿ɹ఩࠸ CAFU v3 ׬શʹཧղͨ͠ - Zenject Λఴ͑ͯ -
2. ͜Μʹͪ͸ʂ 2
3. w$"'6
   W
   ʹ͍ͭͯ
   w;FOKFDU
   ʹ͍ͭͯ
   wॲཧͷྲྀΕΛ௥͏
   wW
   ˠ
   W
   ͷҠߦɾڞଘ 3 ͓͠ͳ͕͖
4. CAFU v3 ʹ͍ͭͯ 4
5. w׬શͳΔ
   $MFBO
   "SDIJUFDUVSF
   ͷ࣮ݱ
   w $MFBO
   "SDIJUFDUVSF
   ୡਓʹֶͿιϑτ΢ΣΞͷߏ଄ͱઃܭ
 3PCFSU
   $.BSUJO
   ֯
   ੐య
   ߴ໦
   ਖ਼߂
   cຊ
   c
   ௨ൢ
 5 ίϯηϓτ About CAFU v3 > Changes
6. w1SFTFOUBUJPO
   ϨΠϠͷґଘͷ޲͖Λ ٯస
   wਖ਼͍͠
   %*1
   ͷ࣮ݱ
   w&OUJUZ
   ͱ
   %BUB
   4USVDUVSF
   ͷ෼཭
   w.PEFM
   ϨΠϠͷഇࢭ 6 Changes from v2 to v3 About CAFU v3
7. 7 Presentation ͷґଘํ޲ٯస About CAFU v3 > Changes
8. 8 Before About CAFU v3 > Changes > Dependency Inversion for Presentation
9. 9 After About CAFU v3 > Changes > Dependency Inversion for Presentation
10. w্ҐͷϨΠϠଆʹ
    JOUFSGBDF
    Λ࡞੒
    w͜ΕͰϨΠϠΛލ͍ͩґଘΛճආ
    wԼҐϨΠϠ͸্ҐϨΠϠͷ
    JOUFSGBDF
    Λ࣮૷
    w6.-
    తͳݴ༿Ͱݴ͑͹࣮ݱ 10 ਖ਼͍͠ DIP ͷ࣮ݱ About CAFU v3 > Changes > Dependency Inversion for Presentation
11. w&OUJUZ
    Λ࠷্ҐϨΠϠͱͯ͠࠶ఆٛ
    w੹຿ʹด࣮ͨ͡૷
    w੹຿ʹԙ͚Δঢ়ଶ
    w%BUB
    4USVDUVSF
    ͱͯ͠ɺ֤຤୺ϨΠϠͰ༻͍Δσʔλߏ଄Λ ఆٛ
    wͦΕͧΕ
    5SBOTMBUPS
    Λ௨ͯ͡
    &OUJUZ
    ͔Β৘ใΛ΋Β͏
    w%BUB
    4USVDUVSF
    ͔ΒಡΈग़ͨ͠৘ใΛ
    &OUJUZ
    ʹ໭͢ͷ΋
    5SBOTMBUPS
    ͷ੹຿ 11 Entity ͱ Data Structure ͷ෼཭ About CAFU v3 > Changes
12. wOBNFTQBDF
    ϨϕϧͰ෼͚Δ͔Ͳ͏͔ ͸ࣗ͝༝ʹ 12 Entity ͱ Data Structure ͷ෼཭ About CAFU v3 > Changes > Split Entity and DataStructure W 㱺 W .PEFM 㱺 %BUB
    4USVDUVSF
 GPS
    1SFTFOUBUJPO
    -BZFS &OUJUZ 㱺 %BUB
    4USVDUVSF
 GPS
    %BUB
    -BZFS
13. wઌड़ͷ௨Γɺ.PEFM
    ϨΠϠΛ
 %BUB
    4USVDUVSF
    ͱͯ͠࠶ఆٛ 13 Model ϨΠϠͷഇࢭ About CAFU v3 > Changes > Split Entity and DataStructure
14. Zenject ʹ͍ͭͯ 14
15. 15 Zenject ͱ͸ About Zenject w%*
    'SBNFXPSL
    w*OTUBMMFS
    ʹܕͷੜ੒ํ๏Λఆٛ ʢ#JOEʣ
    w֤ΫϥεͰ͸஫ೖʢ*OKFDUʣͯ͠ཉ͠ ͍ܕΛએݴ
16. w;FOKFDU
    ͸͡ΊͷҰา
    w;FOKFDU
    ׬શʹཧղͨ͠
    
    6OJUZ
    ઋਓ
    w;FOKFDUͰષͷ৺ΛखʹೖΕΔ
    w͔ͤϊʔτ
    
    ͔ͤ
    wͦͷଞ 16 ࢿྉ About Zenject
17. ॲཧͷྲྀΕ 17
18. wIUUQTHJUIVCDPNNPOSZDBGV@TBNQMF
    wHJU
    QVMM
    
    ZBSO
    ͓͍͍ͯͯͩ͘͠͞ 18 લஔ͖ Process flow
19. w*OTUBMMFS
    ʹͯ
    ;FOKFDU**OJUJBMJ[BCMF
    Λ࣮૷ͨ͠
    6TF$BTF
    Λ
    #JOE
    w6TF$BTF
    ͔ΒҰ࿈ͷґଘΫϥεୡ͕
    *OKFDU
    ͞Ε͍ͯ͘
    w*OJUJBMJ[F
    ಺Ͱ֤छॳظԽΛߦ͏
    wྫ
    (BNF4UBUF6TF$BTF
    ͷ
    **OJUJBMJ[BCMF*OJUJBMJ[F
    ಺Ͱ։࢝༻
    4VCKFDU
    ʹ
    0O/FYU
    w6TF$BTF
    ͕ঢ়ଶΛ؅ཧ͢Δ
    &OUJUZ
    Λૢ࡞͢Δ 19 γʔϯॳظԽ Process flow
20. w*OTUBMMFS
    ʹ
    4FSJBMJ[F'JFME
    ࡞ͬͯɺͦ ΕΛͦͷ··
    'SPN*OTUBODF
    ʹ౉͢ 20 γʔϯ্ͷཁૉΛ Bind ηΫγϣϯλΠτϧ [SerializeField] private ButtonStart buttonStart; private ButtonStart ButtonStart => buttonStart; Container.Bind<ITrigger>() .WithId(Constant.InjectId.ButtonStart) .FromInstance(ButtonStart) .AsCached();
21. wϘλϯͱ͔
    wDBGV@TBNQMF
    Ͱ͸ɺ໘౗ͩͬͨͷͰઐ༻ ͷ
    JOUFSGBDF
    *5SJHHFS
    Λ࡞ͬͨ
    wݸผʹܕΛ༻ҙ͢Δ͔
    #JOE 8JUI*E
    Ͱ ΍Δ͔͸೰·͍͠ͱ͜Ζʜɻ
    wԿ͔ྑ͍ΞΠσΟΞ͋Γ·͔͢Ͷʁ 21 γʔϯ্ͷཁૉΛ Bind Process flow
22. 22 Prefab ͔Βͷ Spawn Process flow [SerializeField] private Mole molePrefab; private Mole MolePrefab => molePrefab; [SerializeField] private Transform moleParent; private Transform MoleParent => moleParent; public override void InstallBindings() { Container // IMoleView の Factory を登録 .BindIFactory<int, IMole, IMoleView>() // Mole 型として .To<Mole>() // MolePrefab 内のコンポーネントを用いて .FromComponentInNewPrefab(MolePrefab) // MoleParent の配下に .UnderTransform(MoleParent);
 }
23. 23 Prefab ͔Βͷ Spawn Process flow [Inject] private IFactory<int, IMole, IMoleView> MoleViewFactory { get; } private List<IMoleView> MoleViewList { get; } = new List<IMoleView>(); public void Instantiate(int index, IMole mole) { var moleView = MoleViewFactory.Create(index, mole); MoleViewList.Add(moleView); } w͜ͷྫͷ৔߹ɺ1SFTFOUFS
    Ͱ
    4QBXO
    ͍ͯ͠Δײ͡
24. 24 Prefab ͔Βͷ Spawn Process flow wύϥϝʔλ౉ͯ͠ॳظԽ͍ͨ͠৔߹ʹ
    'BDUPSZ
    ࢖͏
    wγϯϓϧʹ
    *OTUBOUJBUF
    ͢Δ͚ͩͳΒ
    'BDUPSZ
    φγͰ΋
    0,
    w6OEFS5SBOTGPSN
    Ͱ਌΋ࢦఆՄೳ
25. 25 ը໘ભҠ Process flow w$"'6
    W
    UJNFT
    ;FOKFDU
    ͷͨΊͷը໘ભҠઐ ༻ͷ
    VNN
    Λ࣮૷ࡁ
    w!VNNDBGV@TDFOF
    w
    ݱࡏ
    "TTFU#VOEMF
    ඇରԠ
    wͦΜͳʹֻ͚࣌ؒͣʹରԠͰ͖Δʜͱʜࢥʜʜ
 ʢ͜͜Ͱϝοηʔδ͸్੾Ε͍ͯΔʣ
26. 26 ը໘ભҠ Process flow w!VNNDBGV@TDFOF
    ͷػೳͱͯ͠
 ґଘγʔϯͷࣗಈಡࠐΛ࣮૷ࡁ
    w&EJUPS
    Ͱࣗಈతʹ
    1BSFOU
    $POUSBDUT
    ΛಡΈࠐΉͱ͔΋ରԠࡁ
    w4DFOF4USBUFHZ-JTUBTTFU
    ʹ
 ґଘؔ܎Λఆٛ
27. w͜Ε·Ͱ͸֤γʔϯʹ
    6*
    ༻ͷΧϝϥΛ༻ҙ͍ͯͨ͠ ͕ɺඳըॱͷ໰୊Λճආ͢ΔͨΊͷڞ௨γʔϯΛ࡞੒
    w!VNN[FOKFDU@VJTDFOF
    w6*$BNFSB$PPSEJOBUPS
    ίϯϙʔωϯτΛ
    $BOWBT
    ʹ෇͚Ε͹ɺϤγφʹ
    3FOEFS
    $BNFSB
    Λมߋ͢Δ
    w;FOKFDU
    ͷ
    1BSFOU
    $POUSBDU
    ͱͯ͠
    6*
    Λઃఆ͢ Δඞཁ͋Γ 27 UI γʔϯ ηΫγϣϯλΠτϧ
28. 28 UI γʔϯ ηΫγϣϯλΠτϧ [SerializeField] private SceneStrategyList sceneStrategyList; private ISceneStrategyList SceneStrategyList => sceneStrategyList; public override void InstallBindings() { // シーン読み込みに関する処理群を Install // Generics ナシの SceneInstall の場合 SimpleLoaderUseCase が Bind される // PreLoad/PostUnload の設定を流し込みたいので StrategicLoaderUseCase を利用 SceneInstaller<StrategicLoaderUseCase>.Install(Container); Container.QueueForInject(SceneStrategyList); // シーン読み込み戦略データを Bind // PreLoad/PostUnload の設定を仕込む Container .Bind<IDictionary<string, ISceneStrategy>>() .WithId(CAFU.Scene.Application.Constant.InjectId.UseCase.SceneStrategyMap) .FromInstance(SceneStrategyList.AsDictionary()); }
29. 29 σʔλಡΈॻ͖ Process flow w΋ͷੌ͘γϯϓϧͳσʔλಡΈॻ͖༻ͷ
    VNN
    Λ࣮૷ࡁ
    w!VNNDBGV@EBUB
    w*&OVNFSBCMFCZUF
    Λΰχϣΰχϣ͢Δ܅
    w
    ݱࡏɺϩʔΧϧετϨʔδͱͷର࿩ͷΈ
    w*$SFBUPS
    ͱ͔
    *8SJUFS
    ͱ͔ͷ
    $36%38
    ͳ
    JOUFSGBDF
    Λ
 ੾ͬͯ͋ΔͷͰɺ͜ͷ
    VNN
    Λ֦ு͍͚ͯ͠͹ׂͱࣗ༝ʹ
 σʔλૢ࡞͕Ͱ͖ΔͷͰ͸
30. 30 σʔλಡΈॻ͖ Process flow w!VNNDBGV@EBUB
    Λ࢖͏ͱ͖͸ɺ *OTUBMMFS
    ͰҎԼΛ
    #JOE
    wͲͷ
    3FQPTJUPSZ
    Λ࢖͏ͷ͔ʁ
    wͲͷ
    %BUB4UPSF
    Λ࢖͏ͷ͔ʁ
31. 31 σʔλಡΈॻ͖ Process flow // Repositories Container .BindInterfacesTo<AsyncCRUDRepository>() .AsCached(); // DataStores Container .BindInterfacesTo<AsyncLocalStorageDataStore>() .AsCached();
32. 32 σʔλಡΈॻ͖ Process flow [Inject(Id = Constant.InjectId.ResultListFileUri)] private Uri ResultListFileUri { get; } [Inject] private IAsyncCRUDHandler AsyncCRUDHandler { get; } private async void Read() { var bytes = await AsyncCRUDHandler.ReadAsync(ResultListFileUri); RankingEntitySubject.OnNext( ResultListEntityTranslator.Translate( bytes.FromByteArray<DataResultList>() ) ); RankingEntitySubject.OnCompleted(); } private async void Write() { // 念のため ResultListEntity の生成準備を待つ await RankingEntitySubject; await AsyncCRUDHandler.UpdateAsync( ResultListFileUri, DataResultListStructureTranslator.Translate( RankingEntitySubject.Value ).ToByteArray() ); }
33. v2 → v3 ͷҠߦɾڞଘ 33
34. 34 v2 → v3 ͷҠߦ Migration & Coexistence w!VNNDBGV@DPSF
    ͷ
    .BKPS
    7FSTJPO
    Λ
    
    ʹͯ͠
    ZBSO
    JOTUBMM
    wར༻͢Δ
    "TTFNCMZ
    %FpOJUJPO
    'JMFT
    Λ
    VNN!DBGV@DPSF!W
    ʹ͢Δ
35. 35 v2 ɾ v3 ͷڞଘ Migration & Coexistence w"TTFNCMZ
    %FpOJUJPO
    'JMFT
    Λ෼͚ͯ ͋ΔͷͰ҆৺҆શ
    wಉ࣌ʹ࢖͏৔߹
    JOUFSGBDF
    ͷީิ͕
 ྆ํͷόʔδϣϯͷιϨ͕ग़ͯ͘Δ
 ͷͰ
    *%&
    ্ͰΠϥοͱ͢Δ͔΋
36. Thank you for your listening !! 36