リソースのバージョン管理を手動で行うことによる課題を、チェックサムを導入し自動化することで、解決した事例の紹介。

1. Tech Valley #7
Atsuyuki Nakanishi
リソースのバージョン管理/運用の
失敗談と改善策について

2. About Me
ギークス
ゲーム事業本部
開発1部 部長
中西 敦之
Atsuyuki Nakanishi
html/css/javascript/php/Unity

3. リソース
画像／楽曲／動画等の素材データ＝

4. なぜバージョン管理が必要か？

5. リソースバージョン管理の必要性
downloading
IMG
スマホゲームではリソースをDLし、
ローカルにキャッシュするのが一般的
（表示速度向上／通信量削減）
ダウンロード＆キャッシュ
MP3

6. 約3000リソース
1アプリのリソース数

7. リソースバージョン管理の必要性
リソース更新した場合、どうするの？
↓
再取得のトリガーが必要
↓
バージョン管理
（キャッシュのリソースが古いか判断）

8. 旧バージョン管理
（失敗談）

9. 管理手法 〜旧バージョン管理〜
各関係マスターにversion情報を持たせる
(手動で更新…)
chara_id name … image_version
1 キャラA 1
2 キャラB 3
3 キャラC 1
m_chara

10. フロント 〜旧バージョン管理〜
キャッシュ時に
ファイル名にバージョンを付けて保存
ex) chara_0002_s_3.png
リソース取得時に
最新バージョンのファイル名が
キャッシュに無ければサーバーから取得

11. デメリット

12. デメリット 〜旧バージョン管理〜
【1】version情報が拡散
m_chara, m_music, m_band…
各々のバージョンがそれぞれのマスターに
リソース更新時に
どのバージョンを上げればよいか…迷走...

13. デメリット 〜旧バージョン管理〜
【2】各マスター毎にトリガーを開発
各マスター毎にバージョン管理されているため、
どのマスターのバージョンを見るか個別開発

14. デメリット 〜旧バージョン管理〜
【3】同versionに紐づくリソースが複数
chara_0001_s.png, chara_0001_l.png
⇒ 片方のみ更新でも両方更新扱いになる
（同じversionを見ているため）

15. デメリット 〜旧バージョン管理〜
【4】マスターが無いリソースが面倒
お知らせのバナー等マスター管理されていない
リソースはバージョン更新が出来ないため、
リソース名を変えるしか無い

16. デメリット 〜旧バージョン管理〜
【5】version管理が手動
・更新漏れ等が発生
・不要なバージョン上げてしまったり

17. デメリット 〜旧バージョン管理〜
なんだかとにかく大変。
メンテナンスも拡張も大変。

18. 改善策Ⅰ
バージョン管理を一つのテーブル
にまとめよう

19. 改善策Ⅰ
全リソースのversionを管理するテーブルを作成
resource_name ... … version
images/chara_0001_s.png 1
images/chara_0002_s.png 2
music/music_0001.mp3 1
m_resource

20. 改善策Ⅰ
【1】 version管理が拡散
【2】 各マスター毎にトリガーを開発
【3】 同versionに紐づくリソースが複数
【4】 マスターが無いリソースが面倒
↓
解決

21. 改善策Ⅰ
しかし、
大量にレコードがあるマスターを
手動で更新するのは手間すぎる

22. うーん。
バージョンの概念を無くしたい…
(考えたくない)

23. キャッシュのリソース
と
最新のリソース
が
違うことが分かれば良い

24. 改善策Ⅱ
チェックサムを使う

25. チェックサム
MD5チェックサム
ダウンロードしたソフトウェアが改ざんされていない
ことや壊れていないことを確認するのに利用
MD５
128ビットのハッシュ値を取得
（32桁の16進数、340京通り）

26. 管理手法 〜改善策Ⅱ〜
全リソースのmd5を管理するテーブルを作成
resource_name … … md5_value
images/chara_0001_s.png d41d8cd98f00b204e9800998ecf8427e
images/chara_0002_s.png 9800998ecf8427ed41d8cd98f00b204e
music/music_0001.mp3 d41d8cd98f00b204e9800998ecf8427e
m_resource

27. 更新手法 〜改善策Ⅱ 〜
【1】開発サーバーにリソースをアップ
リソース配信用の特定フォルダ配下に
リソースをアップロード
【2】管理画面からボタンをポチリ
特定フォルダ配下のファイルを
MD5チェック＆m_resourceを更新

28. フロント 〜改善策Ⅱ 〜
リソース取得時
md5値が異なる ⇒ リソースを更新

29. フロント 〜改善策Ⅱ 〜
アプリ起動時に
キャッシュフォルダにある全リソースのmd5値を
非同期でチェック＆保持しておく
※ md5値取得に多少時間がかかるため

30. フロント 〜改善策Ⅱ〜
C#でのmd5取得
using System.Security.Cryptography;
using System.Text;
string GetMD5Value(byte[] bytes) {
MD5CryptoServiceProvider md5 = new MD5CryptoServiceProvider();
byte[] bs = md5.ComputeHash(bytes);
StringBuilder result = new StringBuilder();
foreach (byte b in bs){
result.Append(b.ToString("x2"));
}
return result.ToString();
}

31. まとめ 〜改善策Ⅱ 〜
【1】 version管理が拡散
【2】 各マスター毎にトリガーを開発
【3】 同versionに紐づくリソースが複数
【4】 マスターが無いリソースが面倒
【5】 version管理が手動
↓
解決

32. まとめ 〜改善策Ⅱ 〜
さらに
DL時にデータ破損チェックも可

33. 余談
m_resourceの活用
dl_point, must_flg等のカラムを追加により
指定したタイミングでリソースDLが可能
ex)
＊アプリインストール直後にDL
＊チュートリアル突破直後にDL
＊BGM等,常に最新を落としたいのはmust_flg