# CapabilityPush - iOS 推送能力层

推送能力层模块，提供推送消息接收和处理能力，可独立打包为 SDK。

## 📦 模块结构

```
CapabilityPush/
├── Package.swift              # Swift Package 配置
├── Sources/
│   └── CapabilityPush/
│       ├── CapabilityPush.swift      # 模块入口
│       └── Push/
│           ├── Model/
│           │   └── PushConfig.swift  # 推送配置模型
│           ├── Impl/
│           │   └── PushServiceImpl.swift  # 推送服务实现
│           └── Factory/
│               └── PushServiceFactory.swift  # 推送服务工厂
└── Tests/
    └── CapabilityPushTests/
```

## 🔗 依赖关系

- **BaseCore**: 依赖本地 BaseCore 模块（提供 IPushService 接口和 ILog）

## 📝 使用方式

### 1. 在 Xcode 项目中添加依赖

```swift
// Package.swift 或 Xcode Package Dependencies
dependencies: [
    .package(path: "../CapabilityPush"),
    .package(path: "../BaseCore")
]
```

### 2. 初始化推送服务

```swift
import CapabilityPush
import BaseCore

// 在 AppDelegate 中初始化
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    PushServiceFactory.initialize(
        appKey: "your-jpush-appkey",
        channel: "App Store",
        debugMode: false
    )
    return true
}
```

### 3. 使用推送服务

```swift
let pushService = PushServiceFactory.create()

// 设置别名
pushService.setAlias("user123")

// 设置标签
pushService.setTags(["vip", "premium"])

// 设置消息监听
pushService.setMessageListener { title, content, extras, messageId in
    print("收到消息: \(title) - \(content)")
}

// 注册推送
pushService.register()
```

## 📦 单独打包 SDK

### 方式一：使用 Swift Package Manager

1. **本地打包**：
```bash
cd CapabilityPush
swift build
```

2. **发布到 Git**：
```bash
git tag 1.0.0
git push origin 1.0.0
```

3. **在其他项目中使用**：
```swift
dependencies: [
    .package(url: "https://github.com/your-org/CapabilityPush.git", from: "1.0.0")
]
```

### 方式二：使用 Xcode Archive

1. 在 Xcode 中打开 `CapabilityPush` 项目
2. Product → Archive
3. 导出为 Framework 或 XCFramework

### 方式三：使用 CocoaPods（可选）

创建 `CapabilityPush.podspec`：
```ruby
Pod::Spec.new do |s|
  s.name             = 'CapabilityPush'
  s.version          = '1.0.0'
  s.summary          = '推送能力层模块'
  s.homepage         = 'https://github.com/your-org/CapabilityPush'
  s.license          = { :type => 'MIT' }
  s.author           = { 'Your Name' => 'your@email.com' }
  s.source           = { :git => 'https://github.com/your-org/CapabilityPush.git', :tag => s.version }
  s.ios.deployment_target = '15.0'
  s.source_files = 'Sources/CapabilityPush/**/*.swift'
  s.dependency 'BaseCore'
end
```

## 🔧 集成第三方 SDK

### 集成 JPush iOS SDK

1. 在 `Package.swift` 中添加依赖：
```swift
dependencies: [
    .package(url: "https://github.com/jpush/jpush-ios-sdk.git", from: "5.0.0")
]
```

2. 在 `PushServiceImpl.swift` 中实现具体逻辑：
```swift
import JPush

// 初始化
JPush.setup(withOption: launchOptions, appKey: appKey, channel: channel, apsForProduction: !debugMode)

// 注册设备 Token
JPush.registerDeviceToken(deviceToken)

// 设置别名
JPush.setAlias(alias) { (iResCode, iAlias, seq) in
    // 处理结果
}
```

## 📋 注意事项

1. **依赖管理**：确保 BaseCore 已正确配置
2. **权限配置**：在 `Info.plist` 中配置推送权限说明
3. **AppDelegate 集成**：需要在 AppDelegate 中处理 APNs 回调
4. **测试**：集成 JPush SDK 后需要真机测试

## 🏗️ 架构说明

- **接口定义**：在 BaseCore 中定义 `IPushService` 接口
- **实现类**：在 CapabilityPush 中实现 `PushServiceImpl`
- **解耦设计**：通过接口实现 BaseCore 与 CapabilityPush 的解耦
- **独立打包**：每个能力层都是独立的 Swift Package，可以单独打包和发布