mirror of
https://github.com/R0m1k3/xtremobile.git
synced 2026-10-11 17:29:26 +02:00
Phase 2: Performance Profiling Setup - Add profiling utilities
- Add StartupProfiler: Measure cold/warm start times - Add VideoProfiler: Profile video load, playback metrics - Add MemoryProfiler: Detect memory leaks, monitor heap growth - Add HiveEncryptionBenchmark: Measure encryption overhead - Add PHASE_2_PROFILING_PLAN.md: Complete testing procedures Ready for profiling execution once Flutter SDK is initialized
This commit is contained in:
GitHub Copilot committed
1 parent
1293a159ee
commit
c5fcafcce1
553 files changed
+85219
No files matched your search
@@ -0,0 +1,357 @@
|
||||
# 🚀 PHASE 2: PERFORMANCE PROFILING - EXECUTION PLAN
|
||||
|
||||
**Date:** March 25, 2026
|
||||
**Phase:** 2 of 3
|
||||
**Estimated Duration:** 2-3 hours
|
||||
**Lead:** Amelia (Developer) + Quinn (QA)
|
||||
|
||||
---
|
||||
|
||||
## 📊 PROFILING OBJECTIVES
|
||||
|
||||
1. **Baseline Metrics** - Establish performance baseline post-cleanup
|
||||
2. **Component Benchmarks** - MediaKit vs VideoPlayer tradeoffs
|
||||
3. **Memory Safety** - Detect leaks and lifecycle issues
|
||||
4. **Encryption Overhead** - Hive performance impact
|
||||
5. **Build Optimization** - Measure cleanup impact on build times
|
||||
|
||||
---
|
||||
|
||||
## 🛠️ PROFILING ENVIRONMENT SETUP
|
||||
|
||||
### Prerequisites
|
||||
```bash
|
||||
# 1. Ensure Flutter SDK is initialized
|
||||
export PATH="/path/to/flutter/bin:$PATH"
|
||||
flutter --version
|
||||
|
||||
# 2. Verify Android SDK
|
||||
flutter doctor
|
||||
|
||||
# 3. Connect device or start emulator
|
||||
flutter devices
|
||||
|
||||
# 4. Clean build environment
|
||||
flutter clean
|
||||
flutter pub get
|
||||
```
|
||||
|
||||
### Target Devices
|
||||
- **Primary:** Android 13+ device (real hardware if available)
|
||||
- **Fallback:** Android 10-11 emulator (API 29-30)
|
||||
- **Optional:** Multiple devices for fragmentation testing
|
||||
|
||||
---
|
||||
|
||||
## 📈 2.1: STARTUP TIME PROFILING
|
||||
|
||||
### Cold Start Measurement
|
||||
```bash
|
||||
# Build optimized APK
|
||||
flutter build apk --release
|
||||
|
||||
# Install on device
|
||||
adb install -r build/app/outputs/flutter-app.apk
|
||||
|
||||
# Measure cold start
|
||||
adb shell am instrument -w \
|
||||
-e class=com.xtremflow.mobile.StartupTest \
|
||||
com.xtremflow.mobile.test/androidx.test.runner.AndroidJUnitRunner
|
||||
```
|
||||
|
||||
### Expected Metrics to Capture
|
||||
| Metric | Target | Notes |
|
||||
|--------|--------|-------|
|
||||
| Cold Start | < 2.0s | Full app initialization |
|
||||
| Warm Start | < 0.5s | Background to foreground |
|
||||
| First Paint | < 1.5s | Initial UI rendered |
|
||||
| Interactive | < 2.5s | User interaction possible |
|
||||
|
||||
### Profiling Code
|
||||
Create `lib/core/utils/startup_profiler.dart`:
|
||||
```dart
|
||||
import 'dart:async';
|
||||
import 'package:flutter/foundation.dart';
|
||||
|
||||
class StartupProfiler {
|
||||
static final _timings = <String, Stopwatch>{};
|
||||
|
||||
static void start(String label) {
|
||||
_timings[label] = Stopwatch()..start();
|
||||
if (kDebugMode) print('⏱️ START: $label');
|
||||
}
|
||||
|
||||
static void mark(String label) {
|
||||
final watch = _timings[label];
|
||||
if (watch != null) {
|
||||
watch.stop();
|
||||
final ms = watch.elapsedMilliseconds;
|
||||
if (kDebugMode) print('✅ $label: ${ms}ms');
|
||||
}
|
||||
}
|
||||
|
||||
static Future<void> reportAll() async {
|
||||
if (kDebugMode) {
|
||||
print('\n=== STARTUP METRICS ===');
|
||||
_timings.forEach((key, watch) {
|
||||
print('$key: ${watch.elapsedMilliseconds}ms');
|
||||
});
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
Usage in `main.dart`:
|
||||
```dart
|
||||
void main() async {
|
||||
StartupProfiler.start('app_init');
|
||||
|
||||
WidgetsFlutterBinding.ensureInitialized();
|
||||
await Hive.initFlutter();
|
||||
|
||||
StartupProfiler.mark('hive_init');
|
||||
|
||||
runApp(const MyApp());
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎬 2.2: MEDIAKIT VS VIDEOPLAYER BENCHMARK
|
||||
|
||||
### Test Streams
|
||||
- **IPTV Live:** Use sample M3U playlist (low latency required)
|
||||
- **VOD Movie:** 2-hour file, H.264 codec
|
||||
- **Edge Case:** High bitrate 4K stream (if available)
|
||||
|
||||
### Metrics to Compare
|
||||
```
|
||||
MediaKit Performance:
|
||||
├─ Load Time: [measure]
|
||||
├─ Memory (peak): [measure]
|
||||
├─ CPU (avg): [measure]
|
||||
├─ Codec Support: [test]
|
||||
└─ Seek Response: [measure]
|
||||
|
||||
VideoPlayer Performance:
|
||||
├─ Load Time: [measure]
|
||||
├─ Memory (peak): [measure]
|
||||
├─ CPU (avg): [measure]
|
||||
├─ Codec Support: [test]
|
||||
└─ Seek Response: [measure]
|
||||
```
|
||||
|
||||
### Measurement Code
|
||||
Create `lib/core/utils/video_profiler.dart`:
|
||||
```dart
|
||||
import 'dart:async';
|
||||
import 'package:flutter/foundation.dart';
|
||||
|
||||
class VideoProfiler {
|
||||
static final metrics = <String, StreamMetrics>{};
|
||||
|
||||
static void startStreamMetrics(String streamName) {
|
||||
metrics[streamName] = StreamMetrics(
|
||||
startTime: DateTime.now(),
|
||||
loadStart: DateTime.now(),
|
||||
);
|
||||
}
|
||||
|
||||
static void markLoadComplete(String streamName) {
|
||||
metrics[streamName]?.loadTime =
|
||||
DateTime.now().difference(metrics[streamName]!.loadStart).inMilliseconds;
|
||||
if (kDebugMode) {
|
||||
print('📺 Load Time: ${metrics[streamName]?.loadTime}ms');
|
||||
}
|
||||
}
|
||||
|
||||
static void recordMemoryPeak(String streamName, int bytes) {
|
||||
metrics[streamName]?.peakMemoryMB = bytes ~/ (1024 * 1024);
|
||||
}
|
||||
|
||||
static void recordCpuUsage(String streamName, double percentage) {
|
||||
metrics[streamName]?.avgCpuPercent = percentage;
|
||||
}
|
||||
}
|
||||
|
||||
class StreamMetrics {
|
||||
DateTime startTime;
|
||||
DateTime loadStart;
|
||||
int? loadTime;
|
||||
int? peakMemoryMB;
|
||||
double? avgCpuPercent;
|
||||
bool? seekResponsive;
|
||||
|
||||
StreamMetrics({
|
||||
required this.startTime,
|
||||
required this.loadStart,
|
||||
});
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 💾 2.3: MEMORY LEAK DETECTION
|
||||
|
||||
### Test Procedure
|
||||
1. **Load stream** - MediaKit player
|
||||
2. **Monitor heap** - 15 minutes continuous playback
|
||||
3. **Check growth** - Should plateau after stabilization
|
||||
4. **Lifecycle test** - Pause/resume, hide/show 10 cycles
|
||||
|
||||
### Memory Monitoring
|
||||
```bash
|
||||
# Connect device and run profiling
|
||||
adb shell dumpsys meminfo com.xtremflow.mobile
|
||||
|
||||
# Capture baseline
|
||||
adb shell dumpsys meminfo com.xtremflow.mobile > baseline.txt
|
||||
|
||||
# After 15min playback
|
||||
adb shell dumpsys meminfo com.xtremflow.mobile > after_playback.txt
|
||||
|
||||
# Compare
|
||||
diff baseline.txt after_playback.txt
|
||||
```
|
||||
|
||||
### Critical Metrics
|
||||
- **Native Heap:** Should not grow indefinitely
|
||||
- **Dart Heap:** Should stabilize after initial ramp
|
||||
- **Graphics Memory:** Should be constant during playback
|
||||
- **PSS Total:** Final < Initial + 50MB
|
||||
|
||||
---
|
||||
|
||||
## 🔐 2.4: HIVE ENCRYPTION OVERHEAD
|
||||
|
||||
### Benchmark Code
|
||||
```dart
|
||||
import 'package:hive/hive.dart';
|
||||
import 'dart:typed_data';
|
||||
|
||||
Future<void> benchmarkHiveEncryption() async {
|
||||
// Test data: 1000 playlists × 100 channels each
|
||||
final testBoxName = 'benchmark_test';
|
||||
|
||||
// Scenario 1: Unencrypted writes
|
||||
final unencryptedBox = await Hive.openBox(testBoxName);
|
||||
final unencStart = Stopwatch()..start();
|
||||
|
||||
for (int i = 0; i < 1000; i++) {
|
||||
await unencryptedBox.put('key_$i', 'value_' * 50);
|
||||
}
|
||||
unencStart.stop();
|
||||
|
||||
await unencryptedBox.deleteFromDisk();
|
||||
|
||||
// Scenario 2: Encrypted writes
|
||||
final encryptionKey = Hive.generateSecureKey();
|
||||
final encryptedBox = await Hive.openBox(
|
||||
testBoxName,
|
||||
encryptionCipher: HiveAesCipher(encryptionKey),
|
||||
);
|
||||
final encStart = Stopwatch()..start();
|
||||
|
||||
for (int i = 0; i < 1000; i++) {
|
||||
await encryptedBox.put('key_$i', 'value_' * 50);
|
||||
}
|
||||
encStart.stop();
|
||||
|
||||
await encryptedBox.deleteFromDisk();
|
||||
|
||||
print('Write Performance:');
|
||||
print(' Unencrypted: ${unencStart.elapsedMilliseconds}ms');
|
||||
print(' Encrypted: ${encStart.elapsedMilliseconds}ms');
|
||||
print(' Overhead: ${((encStart.elapsedMilliseconds / unencStart.elapsedMilliseconds - 1) * 100).toStringAsFixed(1)}%');
|
||||
}
|
||||
```
|
||||
|
||||
### Expected Overhead
|
||||
- **Target:** < 15% performance impact
|
||||
- **Acceptable:** < 25% impact
|
||||
- **Concern:** > 30% impact
|
||||
|
||||
---
|
||||
|
||||
## 📋 EXECUTION CHECKLIST
|
||||
|
||||
### Pre-Profiling
|
||||
- [ ] Flutter SDK fully initialized (version 3.x+)
|
||||
- [ ] Android SDK API 30+ available
|
||||
- [ ] Device/emulator connected and responsive
|
||||
- [ ] App builds cleanly (`flutter build apk --release`)
|
||||
- [ ] Logcat cleared: `adb logcat -c`
|
||||
|
||||
### During Profiling
|
||||
- [ ] Device plugged in, not charging (stable power)
|
||||
- [ ] No other apps running
|
||||
- [ ] Network stable (for stream tests)
|
||||
- [ ] Screen timeout disabled
|
||||
- [ ] Developer mode enabled
|
||||
|
||||
### Metrics Collection
|
||||
- [ ] Startup timing (3 runs, average)
|
||||
- [ ] Video load time (MediaKit)
|
||||
- [ ] Video load time (VideoPlayer)
|
||||
- [ ] Memory baseline before/after
|
||||
- [ ] CPU usage during playback
|
||||
- [ ] Hive encryption overhead
|
||||
|
||||
---
|
||||
|
||||
## 📊 RESULTS TEMPLATE
|
||||
|
||||
Create `PHASE_2_PROFILING_RESULTS.md` after execution:
|
||||
|
||||
```markdown
|
||||
# Phase 2 Profiling Results
|
||||
|
||||
## 2.1 Startup Time
|
||||
- Cold Start: XXXms ✅/❌
|
||||
- Warm Start: XXXms
|
||||
- First Paint: XXXms
|
||||
- Bottleneck: [component]
|
||||
|
||||
## 2.2 Video Playback
|
||||
| Component | Metric | Result | Target | Status |
|
||||
|-----------|--------|--------|--------|--------|
|
||||
| MediaKit | Load Time | XXXms | <500ms | ✅/❌ |
|
||||
| MediaKit | Memory | XXmb | <150MB | ✅/❌ |
|
||||
| VideoPlayer | Load Time | XXXms | <500ms | ✅/❌ |
|
||||
| VideoPlayer | Memory | XXmb | <150MB | ✅/❌ |
|
||||
|
||||
## 2.3 Memory Leaks
|
||||
- Baseline PSS: XXmb
|
||||
- After 15min: XXmb
|
||||
- Growth Rate: Xmb/min
|
||||
- Status: ✅ CLEAN / ⚠️ INVESTIGATE
|
||||
|
||||
## 2.4 Hive Encryption
|
||||
- Write Overhead: X%
|
||||
- Read Overhead: X%
|
||||
- Status: ✅ ACCEPTABLE / ⚠️ NEEDS REVIEW
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎯 NEXT STEPS
|
||||
|
||||
**After profiling completes:**
|
||||
1. Execute Phase 3: Architecture Refactor
|
||||
2. Review findings with team
|
||||
3. Create optimization tickets for bottlenecks
|
||||
4. Plan Phase 4: Production Build
|
||||
|
||||
**Ready to proceed?** Run commands in order:
|
||||
```bash
|
||||
flutter clean
|
||||
flutter pub get
|
||||
flutter build apk --release
|
||||
# Then run test procedure for each section
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
**Lead Responsibility:** Amelia
|
||||
**Technical Support:** Winston (Architecture insights)
|
||||
**QA Validation:** Quinn (Test execution)
|
||||
Reference in new issue
Block a user