Xcode：复制标头：公共、私有、项目？

Question

我正在构建一个 Cocoa Touch 静态库。我应该如何决定是否将头文件复制为公共、私有或项目？

Answer 1

公开：界面已最终确定，供您产品的客户使用。公共标头作为可读源代码包含在产品中，不受限制。

私有：该界面不适合您的客户，或者处于开发的早期阶段。产品中包含私有标头，但它被标记为“私有”。因此，这些符号对所有客户端都是可见的，但客户端应该明白他们不应该使用它们。

项目：该接口仅供当前项目中的实现文件使用。项目标头不包含在目标中，目标代码除外。这些符号对客户根本不可见，只有您自己可见。

来源： Xcode 开发者库>工具与语言> IDE >项目编辑器帮助>设置头文件的可见性

Answer 2

兰迪的回答很好，为您提供了所有相关背景。我想添加一些信息来根据您期望的图书馆使用方式为您提供帮助。

项目：如果您要分发项目，并希望用户将您的项目作为子项目包含在自己的项目中，则应确保标头标记为“项目”。不这样做会导致以下问题：
Xcode 4 Archive Version Unspecified

请注意，这适用于每个子项目...包括子项目的子项目，递归。

公共：如果您希望库的用户仅链接到您的对象（并且没有您的原始项目），请确保您的标头标记为“公共”（仅适用于他们需要的标头）参考）。

Answer 3

Objective-C 头文件：公共、私有、项目

[Objective-C 静态库手册]< br>
[目标会员资格]

公共 - 向消费者

私有 - API向消费者公开，但使用它是有风险的

项目 - API对消费者不可见。模块级别的一种封装

文件结构

ClassA.h - public
ClassB.h - project
ClassC.h - private

Headers 文件夹设置为：

Public Headers Folder Path(PUBLIC_HEADERS_FOLDER_PATH)
//default value is
$(CONTENTS_FOLDER_PATH)/Headers

PrivateHeaders 文件夹设置为：

Private Headers Folder Path(PRIVATE_HEADERS_FOLDER_PATH)
//default value is
$(CONTENTS_FOLDER_PATH)/PrivateHeaders

1.暴露 Objective-C 代码对于 Objective-C 或 Swift 使用者，您应该使用 .modulemap 和 public 标头

//Swift
import SomeModule

//Objective-C
@import SomeModule;

[.modulemap] ->仅公共标头或错误

要以非模块使用方式向 Objective-C 使用者公开 Objective-C 代码

//Objective-C

//umbrella
#import <ObjCFramework/ObjCFramework.h>

//specific руфвук
#import <ObjCFramework/ClassA.h>
//#import <ObjCFramework/ClassB.h> //error
#import <ObjCFramework/ClassC.h>

2.当您导入项目标头时，

Showing All Messages
'ObjCFramework/ClassB.h' file not found