开源项目安装配置指南：HXPhotoPicker-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_01232/article/details/143041490

开源项目安装配置指南：HXPhotoPicker

HXPhotoPicker 图片/视频选择器 - 支持LivePhoto、GIF图片选择、3DTouch预览、在线下载iCloud上的资源、编辑图片/视频、浏览网络图片功能 Imitation wx photo/image picker - support for LivePhoto, GIF image selection, 3DTouch preview, Download the resources on iCloud online, browse the web image function 项目地址: https://gitcode.com/gh_mirrors/hx/HXPhotoPicker

项目基础介绍及编程语言

HXPhotoPicker 是一个强大的图片与视频选择器工具，适用于iOS应用开发。它不仅支持基本的图片和视频选取，还扩展了许多高级特性，如LivePhoto和GIF的选择、3D Touch预览、从iCloud在线下载资源、图片及视频编辑等功能。此项目特别适合需要集成复杂多媒体选择逻辑的应用。HXPhotoPicker采用的是Swift编程语言，并且兼容iOS 12.0及以上版本。

关键技术和框架

SwiftUI与UIKit: 根据不同的实现部分，项目结合使用SwiftUI和UIKit进行界面构建，确保灵活性和兼容性。
Kingfisher（可选）: 用于高效的图片异步加载和缓存。
多线程处理: 在一些数据处理和网络请求中，可能涉及到gcd等多线程技术。
国际化: 支持多种语言环境，包括简繁中文、英文、日韩等。
Core Image: 实现图片滤镜和编辑功能。
Photos Framework: 用于访问和管理用户的相册资料。
CocoaPods 和 Swift Package Manager: 提供两种主流的依赖管理方案。

安装和配置教程

准备工作

系统要求: 确保您的开发环境为macOS，拥有最新版本的Xcode（至少支持Xcode 12.0+），以满足Swift 5.4+的需求。
安装Swift Package Manager 或 CocoaPods:
- SwiftPM: Xcode 12及以上版本已内置，无需单独安装。
- CocoaPods: 如果选择使用CocoaPods，通过终端运行sudo gem install cocoapods进行安装。

详细安装步骤

通过Swift Package Manager安装

打开您的Xcode项目。
导航至“File” > “Swift Packages” > “Add Package Dependency…”。
输入项目URL：https://github.com/SilenceLove/HXPhotoPicker.git，并按提示选择合适的版本分支或标签（推荐使用最新稳定版）。
Xcode将自动下载并集成库到项目中。

通过CocoaPods安装

在项目根目录下创建或编辑Podfile。

添加相应的HXPhotoPicker依赖：

use_frameworks!

# 对于完整功能
pod 'HXPhotoPicker'

# 若不需要所有特性，可根据需要选择子库，例如仅选择器功能
pod 'HXPhotoPicker/Picker'

# 执行pod install

在终端定位到Podfile所在目录并运行pod install命令。

配置步骤

Info.plist添加权限:
- 添加NSPhotoLibraryUsageDescription，描述为什么应用需要访问用户的相册。
- 添加NSPhotoLibraryAddUsageDescription，当应用想要保存图片到相册时提供理由。
- 如果启用相机功能，还需添加NSCameraUsageDescription。
- 麦克风使用需添加NSMicrophoneUsageDescription（若涉及录音）。
- 对于iOS 14及以上版本，设置PHPhotoLibraryPreventAutomaticLimitedAccessAlert为YES，避免自动弹出相册访问请求。
集成到项目中:
- 导入头文件：Swift项目中通过import HXPhotoPicker。
- 遵循必要的代理协议，比如PhotoPickerControllerDelegate，以便处理选择事件。
- 实例化PhotoPickerController，配置PickerConfiguration，并设置代理及其它必要属性后呈现控制器。