Security.h 中结构的 macOS 文档

我正在尝试使用Security.h通过 Java 和 JNA 的 macOS 框架。这意味着我需要将某些结构重建为 Java 类。

问题是，当我查看文档中的结构时（this one https://developer.apple.com/reference/security/seckeychainitemref?language=objc，例如），我看到的只是该结构的简短描述，没有提及其字段。在哪里可以获取 Apple 文档中结构体的完整描述？

为了快速查看，您可以找到标题Apple 的开源网站 https://opensource.apple.com/，但很难导航，特别是根据您要检查的操作系统版本，标题位于不同的位置。在所有情况下，我发现它的定义是SecBase.h。例如这是最新 macOS 的版本 https://opensource.apple.com/source/Security/Security-57740.51.3/base/SecBase.h.auto.html.

你就得到了这个：

typedef struct CF_BRIDGED_TYPE(id) SECTYPE(SecKeychainItem) *SecKeychainItemRef;

因此，您可能需要其他标头来跟踪结构的确切字段。更好的方法是安装 XCode 以及您想要的操作系统的框架，然后您将在本地系统上获得标头。例如：

$ ls /Applications/Xcode.app/Contents/Developer/Platforms/*.platform/Developer/SDKs/*.sdk/System/Library/Frameworks/Security.framework/Headers/SecBase.h
/Applications/Xcode.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Security.framework/Headers/SecBase.h
/Applications/Xcode.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS9.2.sdk/System/Library/Frameworks/Security.framework/Headers/SecBase.h
/Applications/Xcode.app/Contents/Developer/Platforms/AppleTVSimulator.platform/Developer/SDKs/AppleTVSimulator.sdk/System/Library/Frameworks/Security.framework/Headers/SecBase.h
/Applications/Xcode.app/Contents/Developer/Platforms/AppleTVSimulator.platform/Developer/SDKs/AppleTVSimulator9.2.sdk/System/Library/Frameworks/Security.framework/Headers/SecBase.h
/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.11.sdk/System/Library/Frameworks/Security.framework/Headers/SecBase.h
/Applications/Xcode.app/Contents/Developer/Platforms/WatchOS.platform/Developer/SDKs/WatchOS.sdk/System/Library/Frameworks/Security.framework/Headers/SecBase.h
/Applications/Xcode.app/Contents/Developer/Platforms/WatchOS.platform/Developer/SDKs/WatchOS2.2.sdk/System/Library/Frameworks/Security.framework/Headers/SecBase.h
/Applications/Xcode.app/Contents/Developer/Platforms/WatchSimulator.platform/Developer/SDKs/WatchSimulator.sdk/System/Library/Frameworks/Security.framework/Headers/SecBase.h
/Applications/Xcode.app/Contents/Developer/Platforms/WatchSimulator.platform/Developer/SDKs/WatchSimulator2.2.sdk/System/Library/Frameworks/Security.framework/Headers/SecBase.h
/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/Security.framework/Headers/SecBase.h
/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS9.3.sdk/System/Library/Frameworks/Security.framework/Headers/SecBase.h
/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneSimulator.platform/Developer/SDKs/iPhoneSimulator.sdk/System/Library/Frameworks/Security.framework/Headers/SecBase.h
/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneSimulator.platform/Developer/SDKs/iPhoneSimulator9.3.sdk/System/Library/Frameworks/Security.framework/Headers/SecBase.h

不过，我对在线文档没有很好的解决方案。

另一种方式，从记忆中，它对于在 Java 中为 JNA 重新创建结构的任务更有帮助，那就是构建一个最小的 C 程序（但我不确定如何在 macOS 上做到这一点，与安全框架链接，也许你做），并且将其交给 gdb 打印结构布局 using ptype:

(gdb) whatis v
type = struct complex
(gdb) ptype v
type = struct complex {
    double real;
    double imag;
}

但正如评论中指出的，如果我们在这里尝试，我们会得到：

(gdb) ptype SecKeychainItemRef
type = struct OpaqueSecKeychainItemRef {
  <incomplete type>
}

恐怕这个符号是自愿变得不透明的......由 Brendan 在评论中确认：

我能想到的每一种 macOS 类型都以Ref是不透明类型 （实际上是一个指针），仅用于传递给函数

Here is a debug session with Xcode: