Agora-MoonLight iOS/Mac上的性能測試組件

MoonLight是iOS/Mac上的性能測試組件，它可以單獨集成在任何App中實現自動化性能數據的采集，你可以非常輕松的獲取到App CPU、System CPU、App Memory、System GPU以及 GPU Info的數據。

MoonLight的愿景

MoonLight，它的中文意思名為月光。月光彌漫在地球之上是寧靜且自然的，月光會給予地球上的人們以指引。而月光的寓意恰好和我們開發性能測試組件的出發點相契合。

我們希望iOS/Mac的性能測試也能像月光一樣，輕松且自然。MoonLight有著更低的性能消耗，更容易的使用方式，更精準的性能數據。它將幫助開發團隊更快速更精確的定位性能問題，進而推動性能優化和提升。幫助測試團隊更快更準的獲取性能數據，提升測試效率。

對比其他的性能測試工具

Instruments

MoonLight采集到的性能數據是基本和Instruments保持一致的。具體的優劣對比如下：

1. Instruments無法實現性能自動化,無法將獲取到的性能數據提取出來進行分析，最后提供出去的性能數據準確度不夠，存在人為誤差。MoonLight可以解決這個問題。

2. Instruments無法實現遠程性能測試，自然也無法實現高并發的性能測試，通常來說需要一臺設備連接USB線后測試，然后一臺測試完再測試下一臺。MoonLight可以一次性測試非常多臺，也沒有必須連接數據線的要求。

3. 高版本的Instruments無法測試一些低端系統機器的性能，MoonLight可以完美支持。

4. 對于macOS上的App, Instruments是不支持GPU的輸出，MoonLight支持。進過測試，GPU的輸出和macOS自帶的活動管理器GPU輸出保持一致。

5. Instruments優點是數據可視化，并且可以提供內存泄漏測試。MoonLight暫時不提供數據可視化，但是由于MoonLight是可編程的，當開發者拿到相關的性能數據后, 可以自行實現數據上報或者可視化的處理。

GT

1. GT不支持macOS，MoonLight支持。

2. GT采集到的App Memory數據和Instruments是不一致的。GT 無法輸出 GPU、System CPU, 但是MoonLight可以。

3. GT集成到App中，需要添加非常多的依賴庫，取消掉Bitcode支持，自身也比較龐大，并且會增加App的包大小。MoonLight更輕量化，對于iOS僅僅只需要增加一個系統庫，對于Mac不需要增加任何的系統庫。

Perfdog

1. Perfdog無法支持macOS上的App的性能測試。

2. Perfdog并非是一個自動化的性能測試工具，優點是數據可視化。

3. Perfdog并非是一個開源的測試工具，之前在iOS 14上出現過App CPU不準的Bug, 而我們也并不清楚其實現的原理和代碼，未來依舊有可能在某些系統上出現性能項測試不準的情況。

系統要求

• iOS 8.0+
• macOS 10.11+

安裝

Cocoapods

• iOS:

Warning! For iOS, do not use it on AppStore release. Recommend use it on debug mode.

pod 'MoonLight_iOS', :configurations => ['Debug']

• macOS:

pod 'MoonLight_macOS'

Usage

// Step1: create MoonLight instance and set sampling interval.
	_moonLight = [[MoonLight alloc]initWithDelegate:self timeInterval:1];

// Step2: start timer.
	[_moonLight startTimer];


// Step3: through the callback, you can get all the performance data per interval.
- (void)captureOutputAppCPU:(float)appCPU systemCPU:(float)systemCPU appMemory:(float)appMemory gpuUsage:(float)gpuUsage gpuInfo:(NSString *)gpuInfo {
	NSLog(@"appMemory:%f", appMemory);
	NSLog(@"appCPU:%f", appCPU);
	NSLog(@"gpuUsage:%f", gpuUsage);
	NSLog(@"systemCPU:%f", systemCPU);
	NSLog(@"gpuInfo:%@", gpuInfo);
}

// Step4：if you want to stop capturing the performance data, use "stopTimer".
	[_moonLight stopTimer];