HXPhotoPicker 开源项目教程

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

1. 项目目录结构及介绍

HXPhotoPicker 的目录结构设计清晰，便于理解和使用。以下是主要的组成部分：

• Sources: 这是代码的主要存放地，包含了不同功能模块的源码文件。

  • HXPhotoPicker: 核心组件，如 Core、Picker 和 Editor 等子目录。
    • Core: 包含项目的核心逻辑和通用类。
    • Picker: 相册选择相关的实现。
    • Editor: 图片和视频编辑的实现。
    • Camera: 相机功能的实现。
    • Lite 子目录对应轻量级的实现，用于只包含部分功能的场景。

• Sources/HXPhotoPicker/Resources: 这里存储了项目所需的资源文件，包括图片、隐私政策等。

• podspec: 包含HXPhotoPicker.podspec文件，这是CocoaPods用来管理依赖关系和编译设置的。

2. 项目启动文件介绍

在iOS应用中，通常入口点是AppDelegate.swift 文件中的 application(_:didFinishLaunchingWithOptions:) 方法。但具体到HXPhotoPicker，这是一个库而非完整的应用程序，因此没有传统的启动文件。使用者需要将库集成到自己的项目中，然后在需要调用相册选择或编辑功能的地方引入相应的类和方法。

例如，要在某个ViewController中启动相册选择，你需要导入HXPhotoPicker库，并创建一个HXPhotoManager实例来初始化并展示相册选择界面。

import HXPhotoPicker

class MyViewController: UIViewController {
    override func viewDidLoad() {
        super.viewDidLoad()
        
        let manager = HXPhotoManager.default
        manager.showPhotoPicker(viewController: self)
    }
}

3. 项目的配置文件介绍

HXPhotoPicker 并不依赖于特定的配置文件，而是通过运行时设置或者在Info.plist中添加权限声明来配置。为了正确使用HXPhotoPicker，你需要在Info.plist中添加以下键值对以获取必要的权限：

• NSPhotoLibraryUsageDescription: 允许访问相册的描述。
• NSPhotoLibraryAddUsageDescription: 允许保存图片至相册的描述（适用于iOS 11及以上）。
• PHPhotoLibraryPreventAutomaticLimitedAccessAlert: 设置为YES以避免在iOS 14+系统中自动弹出“添加更多照片”的提示。

此外，如果项目中使用了相机功能，还需要添加以下权限：

• NSCameraUsageDescription: 允许使用相机的描述。
• NSMicrophoneUsageDescription: 允许使用麦克风的描述（仅当需要录制带有音频的视频时）。

确保在使用HXPhotoPicker之前已向用户请求了这些权限，否则某些功能可能无法正常使用。

完成上述步骤后，你就可以在自己的iOS项目中使用HXPhotoPicker提供的照片/视频选择、编辑和相机功能了。记得遵循Apple的隐私政策和用户同意机制，以便提供最佳的用户体验。

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