はじめに
この記事はサムザップ #2 Advent Calendar 2020の12/14の記事です。
前日は @leosuke さんのエンジニアらしく本を整理したい... 「Yahoo Web API を用いたバーコード読み取りによる本整理術」 - Qiitaでした。
モチベーション
個人的にUnityで作成した、Androidアプリの動作確認を行っていたところ
ファイルを作成する処理で、実行を繰り返すごとにパフォーマンスが悪化しているものがありました。
アプリを新規インストールし直すとまたもとのパフォーマンスに戻るため、
もしかするとディレクトリに存在するファイルの数に影響を受けているのかと思い、調べてみることにしました。
パフォーマンス計測コードの作成
前準備
Performance testing API パッケージの導入
実機上でのパフォーマンス計測には、UnityからPerformance testing APIという便利なパッケージが提供されていますので、それを使うことにします。
Performance testing APIは2020/12/11時点でまだpreviewパッケージしか提供されておりませんので、
「Package Manager」ウィンドウ上部の「Advanced」から「Show preview packages」にチェックを入れます。
すると画像のようにパッケージが表示されると思いますので、こちらをインストールします。
インストールが終わったら、パッケージのドキュメントに従っていくつかの設定を行います。
link.xmlの追加
IL2CPPのマネージドコードストリッピングが有効になっている場合、計測に必要なコードが取り除かれてしまいますので、
それを避けるためlink.xmlへ下記の項目を追加します。
<linker>
<assembly fullname="Unity.PerformanceTesting" preserve="all"/>
</linker>
テスト用のアセンブリの作成
パッケージの導入が完了しましたら、
Projectウィンドウを右クリック→「Create」→「Testing」→「Tests Assembly Folder」を選択して、テスト用のアセンブリを作成します。
次にPerformance testing APIを利用するため、作成された Tests.asmdef を選択し、
そのInspectorからAssembly Definition ReferencesへUnity.PerformanceTestingの参照を追加します。
計測コードの実装
前準備が終わったので、パフォーマンスを計測するコードを実装します。
まず単なるC#のクラスを作成し、
public class FilePerformanceTest
{
}
計測を行うメソッドへTest属性、Performance属性を指定して、
計測対象の処理をMeasure.Methodへ渡すActionに記述します。
private static string BasePath => Path.Combine(Application.persistentDataPath, "test");
private static readonly byte[] _dummyData = new byte[4096];
[Test]
[Performance]
public void CreateTest()
{
Measure.Method(() =>
{
string path = Path.Combine(BasePath, Guid.NewGuid().ToString("D"));
using (var fs = File.Create(path))
{
fs.Write(_dummyData, 0, _dummyData.Length);
}
})
.Run();
}
今回はファイル数の違いによるパフォーマンスの変化も確認したいため複数のパラメータで計測が行えるように設定します。
CreateTestメソッドに引数とTestCase属性を追加して、Measure.Methodの実行前にダミーのファイルを作成するコードを追加します。
[TestCase(0)]
[TestCase(64)]
[TestCase(512)]
[TestCase(4096)]
[Test]
[Performance]
public void CreateTest(int numExistsFile)
{
for (int i = 0; i < numExistsFile; ++i)
{
string path = Path.Combine(BasePath, i.ToString("04D"));
File.WriteAllBytes(path, _dummyData);
}
Measure.Method(() =>
...
最後に計測の実施毎にファイルが残り続けないよう、
SetUp属性とTearDown属性を使ってディレクトリの作成と後始末の処理を追加します。
[SetUp]
public void Initialize()
{
Directory.CreateDirectory(BasePath);
}
[TearDown]
public void Cleanup()
{
Directory.Delete(BasePath, recursive: true);
}
このようにPerformance testing APIを使うと、通常のテストコードと同じような要領で計測コードを実装することができます。
実行も同じようにできるため、一通り実装が完了したら、UnityEditor上でテストを実行して動作確認するとよいでしょう。
コード全文
using System;
using System.IO;
using NUnit.Framework;
using Unity.PerformanceTesting;
using UnityEngine;
public class FilePerformanceTest
{
private static string BasePath => Path.Combine(Application.persistentDataPath, "test");
private static readonly byte[] _dummyData = new byte[4096];
[SetUp]
public void Initialize()
{
Directory.CreateDirectory(BasePath);
}
[TearDown]
public void Cleanup()
{
Directory.Delete(BasePath, recursive: true);
}
[TestCase(0)]
[TestCase(64)]
[TestCase(512)]
[TestCase(4096)]
[Test]
[Performance]
public void CreateTest(int numExistsFile)
{
for (int i = 0; i < numExistsFile; ++i)
{
string path = Path.Combine(BasePath, i.ToString("04D"));
File.WriteAllBytes(path, _dummyData);
}
Measure.Method(() =>
{
string path = Path.Combine(BasePath, Guid.NewGuid().ToString("D"));
using (var fs = File.Create(path))
{
fs.Write(_dummyData, 0, _dummyData.Length);
}
})
.WarmupCount(1)
.MeasurementCount(3)
.Run();
}
}
パフォーマンス計測の実行
予めAndroid実機をPCへ接続し、USBデバッグを有効にしておきます。
「Test Runner」ウィンドウの右上から「Run all in player(Android)」を選択して、計測を実行します。
UnityEditorのConsoleに Saving results to: ~ と出力されたら計測は完了です。
メニューの「Window」→「Analysis」→「Performance Test Report」から計測結果を確認します。
結果
手元にあったAndroid端末(Snapdragon 855 / Android 10)で計測したところ、結果は次の画像のようになりました。
計測結果の中央値（Median）に着目すると、0個と64個の場合はほぼ同じものの、
以降の512個、4096個のケースでは、ファイル作成にかかった時間が増えていることが分かりました、
以上になります。
明日は @s_ebata さんの記事です。
環境
- Unity 2019.4.4f1
- Performance testing API version 2.4.1