# SSSDKUIKit

**Repository Path**: ios_shen/SSSDKUIKit

## Basic Information

- **Project Name**: SSSDKUIKit
- **Description**: No description available
- **Primary Language**: Objective-C
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-20
- **Last Updated**: 2026-08-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SSUIKit-SDK

SSUIKit-SDK 是一个基于 UIKit 的 iOS 快速开发工具库，提供常用宏定义、UI 初始化快捷方法及各类扩展，帮助开发者高效构建 iOS 应用界面。

## 特性

- 🚀 **常用宏定义**：屏幕尺寸、设备类型、颜色快捷宏等
- 🎨 **UI 快捷初始化**：一行代码创建常用 UI 控件
- 🔧 **Foundation 扩展**：NSString、NSArray、NSDictionary、NSObject 等实用方法
- 📱 **UIKit 扩展**：UIView、UILabel、UIButton、UIImage、UIColor、UITextField、UITableView、UIViewController 等链式/快捷 API
- 📦 **零依赖**：纯 UIKit 封装，无第三方依赖

## 环境要求

- iOS 13.0+
- Xcode 12.0+
- Objective-C

## 安装

### CocoaPods（即将支持）

```ruby
pod 'SSUIKit-SDK'
```

### 手动集成

1. 下载本项目
2. 将 `SSUIKit` 文件夹拖拽到您的工程中
3. 在需要使用的地方 `#import "SSUIKit.h"`

## 使用示例

### 宏定义

```objc
#import "SSUIKit.h"

// 屏幕宽高
CGFloat screenW = SS_SCREEN_WIDTH;
CGFloat screenH = SS_SCREEN_HEIGHT;

// 状态栏高度
CGFloat statusH = SS_STATUS_BAR_HEIGHT;

// 快捷颜色
UIColor *color = SS_HEXCOLOR(0xFF5722);
UIColor *colorWithAlpha = SS_HEXCOLOR_A(0xFF5722, 0.5);
```

### UI 快捷初始化

```objc
// 快捷创建 UILabel
UILabel *label = [UILabel ss_labelWithText:@"Hello" fontSize:16 color:SS_HEXCOLOR(0x333333)];

// 快捷创建 UIButton
UIButton *btn = [UIButton ss_buttonWithTitle:@"Click" titleColor:[UIColor whiteColor] bgColor:SS_HEXCOLOR(0x1890FF)];

// 链式设置 UIView
view.ss_frame(10, 100, 200, 44).ss_bgColor([UIColor redColor]).ss_cornerRadius(8);
```

## Demo 工程

项目包含一个完整的 Demo 工程，用于演示各扩展模块的功能。

### 运行 Demo

1. 打开 Xcode，新建一个 iOS App 工程
2. 将 `Demo/SSUIKitDemo/` 下的所有源文件拖入工程
3. 将 `SSUIKit/` 文件夹以 **Create folder references** 方式拖入工程
4. 编译运行即可

### Demo 页面

| 页面 | 功能 |
|------|------|
| **宏定义展示** | 屏幕尺寸、设备信息、颜色宏、适配宏的实时展示 |
| **Foundation 扩展** | NSString 校验/编解码、NSArray 函数式操作、NSDictionary 安全取值 |
| **UIView 扩展** | Frame 快捷属性、链式调用、阴影/渐变/圆角、弹动/抖动/渐隐动画 |
| **UIKit 控件扩展** | Label、Button、TextField、Image、Color 等快捷创建和效果展示 |

### 编译后自动同步 SDK

Demo 工程提供了编译脚本 `Demo/SSUIKitDemo/build_sync_sdk.sh`，可在每次编译后自动将最新的 SDK 源码同步到指定目录。

#### 配置方法

1. 在 Xcode 工程中，选中 Target → **Build Phases**
2. 点击 **+** → **New Run Script Phase**
3. 在脚本框中填入：

```bash
bash "${SRCROOT}/Demo/SSUIKitDemo/build_sync_sdk.sh"
```

4. 将新建的 Run Script Phase 拖动到 **Compile Sources** 之后

#### 自定义输出目录

如需将 SDK 同步到其他目录，可在脚本前设置环境变量：

```bash
export SDK_OUTPUT_DIR="${SRCROOT}/../MyProject/SSUIKit"
bash "${SRCROOT}/Demo/SSUIKitDemo/build_sync_sdk.sh"
```

默认同步到项目根目录的 `SSUIKit/` 文件夹。

## 目录结构

```
SSUIKit/
├── SSUIKit.h              # 主头文件，一键导入所有模块
├── Macros/
│   ├── SSUIMacros.h       # UI 相关宏（屏幕、尺寸、适配）
│   ├── SSDeviceMacros.h   # 设备相关宏（机型、系统版本）
│   ├── SSColorMacros.h    # 颜色相关宏
│   └── SSFunctionMacros.h # 常用函数宏
├── Foundation/
│   ├── NSString+SSExtension.h/.m
│   ├── NSArray+SSExtension.h/.m
│   ├── NSDictionary+SSExtension.h/.m
│   └── NSObject+SSExtension.h/.m
└── UIKit/
    ├── UIView+SSExtension.h/.m
    ├── UILabel+SSExtension.h/.m
    ├── UIButton+SSExtension.h/.m
    ├── UIImage+SSExtension.h/.m
    ├── UIColor+SSExtension.h/.m
    ├── UITextField+SSExtension.h/.m
    ├── UITableView+SSExtension.h/.m
    └── UIViewController+SSExtension.h/.m
```

## 贡献

欢迎提交 Issue 和 Pull Request。

## 许可证

SSUIKit-SDK 基于 MIT 许可证开源，详见 [LICENSE](LICENSE) 文件。