# LoveLive Music Player — KMP + Compose Multiplatform

与 Flutter 仓库 `LoveLiveMusicPlayerMobile` **并列**。UI 使用 Compose Multiplatform（Android / iOS 一致）；PC 仍为 Electron，本仓库提供协议客户端与共享模型。

包名：`top.zhushenwudi.llmp`

## Maven / Nexus

`settings.gradle.kts` 已对齐 Flutter `android/nexus_repos.gradle`：

- 探测 `http://192.168.123.100:18081/service/rest/v1/status`（2s）
- 可达 → `maven-public` / `google` / `mob` / `gradle`(插件) / `jitpack`
- 不可达 → 公网 `google()` / `mavenCentral()` / `gradlePluginPortal()` 等
- 强制：`-PuseNexus=true|false`

## 模块

| 模块 | 职责 |
|------|------|
| `:shared` | 协议、模型、SQLDelight、OSS、歌词、传歌/同步、Player、Settings、FileSystem、PlatformServices |
| `:composeApp` | CMP UI + Android 原生（Glance Widget、LyricService、扫码、WebView） |
| `iosApp/` | Xcode 脚手架（CarPlay / PiP / WidgetKit），需 macOS 签名链接 |

## 构建（Windows）

```bash
./gradlew.bat :shared:testDebugUnitTest
./gradlew.bat :composeApp:assembleDebug
./gradlew.bat :composeApp:installDebug
```

Debug APK：`composeApp/build/outputs/apk/debug/composeApp-debug.apk`

## 原生功能矩阵

| 功能 | Android | iOS | 状态 |
|------|---------|-----|------|
| 播放引擎 | ExoPlayer（单实例 + MediaSession） | AVPlayer + MPNowPlaying / RemoteCommand | **done** |
| `FileSystem.writeBytes` | 完整 | NSData 原子写入 | **done** |
| 桌面歌词 | `LyricService` 悬浮窗 + 设置开关 | PiP（`iosApp/pip/*`，Swift） | **done**（iOS 需 Mac 链 framework） |
| Home Widget | Glance 四样式 + `HomeWidgetPreferences` | WidgetKit White/Black（`iosApp/WidgetExtension`） | **done**（iOS 需 Xcode target） |
| CarPlay | 目录模型 `CarPlayCatalog`（common） | `CarPlaySceneDelegate` Tab Music/Album/Mine | **sources done**；真机需 Apple **carplay-audio** entitlement |
| 深链 `llmp://` | Manifest + `DeepLinkHandler` | SceneDelegate + App Group | **done** |
| USB 挂载监听 | Broadcast + `UsbMountMonitor` | N/A（NoOp） | **done**（Android） |
| 系统分享 | `ACTION_SEND` | UIActivity / Notification → Swift | **done**（最低系统分享） |
| QR 扫码 | ZXing embedded `QrScanActivity` | IP 粘贴（相机可在 Swift 补） | **done**（Android 真扫） |
| 萌娘百科 / 立绘 | `WebViewActivity` + assets/tachie | `openURL` / Safari | **done** |
| 友盟 | `UmengBridge` 反射（key `634bd9c688ccdf4b7e4ac67b`） | 需在 Swift 初始化 iOS key | **done**（Android 反射；SDK 可选） |
| PlatformServices | MainActivity `installAndroidPlatformServices` | `installIosPlatformServices` | **done**（非 NoOp 默认） |

### 仍需 macOS / Apple 开发者完成的项

1. **Xcode 工程**：创建 App + Widget Extension，链接 `ComposeApp.framework`（`./gradlew :composeApp:linkDebugFrameworkIosSimulatorArm64`）
2. **签名 / App Group**：`group.top.zhushenwudi.llmp`（已从 Flutter `group.com.zhushenwudi.lovelivemusicplayer` 迁移；见 `iosApp/README.md`）
3. **CarPlay entitlement**：`com.apple.developer.carplay-audio` + `playable-content` 需 Apple 审批后真机可用
4. **PiP 资源**：`black.mp4`（Flutter 仓库若缺失需自行放入 `iosApp/iosApp/pip/`）
5. **Swift ↔ Kotlin 播放回调**：Widget/CarPlay 的 NotificationCenter 事件需在 Mac 上接到 `AppContainer.player`

## 已实现业务（相对骨架）

1. OSS 元数据入库、曲库 6 Tab、播放队列、滚动歌词、Love/歌单/History
2. WiFi 传歌 / 数据同步、驾驶模式、SD/USB、设置、每日推送
3. 桌面歌词 / Widget / 扫码 / WebView / 分享 / 深链 / 友盟桥
4. `FeatureModuleIndex` 模块清单（日志页）

## 对照

| 主题 | Flutter | 本仓库 |
|------|---------|--------|
| Nexus | `android/nexus_repos.gradle` | `settings.gradle.kts` |
| 常量 | `lib/global/const.dart` | `Const.kt` |
| 入库 | `global_db.dart` | `DataImportService` |
| 协议 | Docs `03` | `protocol/*` + `transfer/*` |
| 歌词 | `global_lyric.dart` | `lyric/*` + `native/LyricService` |
| Widget SP | `HomeWidgetPreferences` | 同名键 |
| CarPlay | `lib/pages/carplay/*` | `CarPlayCatalog` + Swift Scene |
| UI | GetX | `composeApp` CMP |

文档：`E:\LoveLiveMusicPlayer-Docs\`