问题标签 [appledoc]

我正在使用 appledoc 制作 Objective-C(iOS) 静态库的文档。文档是为客户制作的，我不想记录私有方法。如何防止记录私有方法？

这是关于CGImageCreateWithImageInRect的文档。

它接受一个 CGRect 对象作为参数。据我了解，CGRect 以点为单位

但是文档说：

“引用生成的矩形内的像素，将矩形内的第一个像素视为子图像的原点。”

这似乎不准确，并且在我需要调整 UIImage 大小时得到了证明。我需要将图像尺寸乘以屏幕比例，否则我的图像尺寸错误

如果我不按比例相乘，图像就太小了。

我是对的，这是一个糟糕的文档（因为它不应该采用以点为单位的 CGRect，然后将其读取为像素）还是我不理解这里的基本内容？

我创建了一个以块为参数的方法。该块需要一些参数，所以我想像 Apple 在他们的具有相似格式的方法中那样缩进文档......

一个简单的例子是：

但很明显，这只会在文档中出现：

我如何获得data并fields显示像 Apple 的方法一样缩进，该方法采用带参数的块？

我在Apple 的 HeaderDoc 文档中找不到如何执行此操作

我上个月下载了 apple researchkit 并运行了它的示例。它奏效了，一切都很好。这周我尝试运行它，我构建失败了，错误是我需要appledoc：

错误：构建 ResearchKit 的文档需要 appledoc。见http://appledoc.gentlebytes.com

我做了一些研究，发现了这个页面

我下载了项目并构建了它，我找到了我的

构建目录。

但是，我不知道这个目录中的可执行文件是什么以及如何将它添加到路径中。有人能帮我吗 ？多谢。

我有一些这样的代码注释：

所以代码示例缩进了 4 个空格。当我使用 appledoc 编译 docset 时，它会正确编译并将代码显示为我生成的 API 参考中的代码。但是回到 XCode（我有 appledoc 为 doco 中的问题创建警告的地方）我收到警告：

我认为发生的事情是 appledoc 正在代码块内寻找降价链接。

如何阻止此警告出现？

我大家，

我正在尝试开发两个充当中央和外围设备的应用程序，当它们进入蓝牙范围时，它们会自动相互连接，而两者都在后台。

我在这篇文章中发布了一些关于我的问题的内容（因为我的测试都不是结论性的）：IOS 开发：后台 BLE 扫描。

我总是在互联网上找到的答案直接来自 Apple 文档。一个帖子示例（https://stackoverflow.com/a/20460113/5464805）：

问题是前景和背景扫描的差异。当您在前台扫描设备时，您可以扫描任何内容。在后台，您必须指定您正在扫描的实际服务 UUID。好的，这实际上不是问题，因为您知道要查找的 UUID。

外围设备：作为外围设备的广播再次在前台和后台工作不同。在前台，它像任何普通的 BT 外围设备一样工作。在后台它的工作空间非常有限，因此您的外围设备UUID 被隐藏起来而不是广播。只有当中央设备（前台的 iPhone）向它请求信息时，它才会唤醒您的应用程序并显示它的 UUID。

所以这2个互相抵消了。由于您的后台扫描只能扫描具有特定 UUID 的设备，并且您的后台外围设备无法宣传其 UUID，因此它们无法看到彼此。

但是有一些我不明白的地方：在我的中心，我已经指定了 UUID [centralmgr scanForPeripheralsWithServices:[NSArray arrayWithObject:servicesUUID] options:scanOptions];。根据上面详述的功能，当外围设备在后台而中央设备在前台时，它不应该连接，但它确实如此！

有人知道在这种特定情况下发生了什么吗？或者也许是让我的两个设备在后台连接的解决方案？

谢谢！

PS：我找到的答案也很老（2013）。

我目前正在构建用 Objective-C 编写的 iOS SDK。现在我已经测试并准备好了 SDK，希望结合 Swift 和 Objective-C 向其中添加文档。我一直致力于以下文档生成器工具

一个。多氧

湾。苹果文档

C。爵士乐

d。苹果的 HeaderDoc。

我想使用我的 Objective-C 头文件中的注释并为 Objective C 和 Swift 生成组合帮助，类似于Apple最近的做法。我的问题是如何从 Objective-C 标头生成 Swift 和 Objective-C 的文档？

以下是基于我的研究的一些链接：

• https://github.com/realm/jazzy/issues/353
• https://github.com/jpsim/SourceKitten/pull/95

谢谢，

内存。

请在此处参考苹果文档：

我已经定义了一个协议并将 HeaderDoc 文档添加到该协议中的方法中。当我 Option+单击该方法时，它会正确显示：

但是，当我 Option+单击实现此协议的控制器中的实现时，文档未显示：

我的期望是我为协议编写的文档会出现在控制器中，类似于 Apple 的文档：

如何让我的协议文档在其他地方可见？

我在整个应用程序中使用 NsUrl Session。他们是否需要更改 API。WILL 苹果会批准我的APP.My api http://alatiffy.com/webservice/terms.php

我正在尝试运行这个脚本作为使用 appledoc 插件生成文档的一部分。但是，我收到了这个“预期的行尾，但找到了标识符”。在 Xcode（或终端）中运行此脚本时出错。请帮助我，因为我是脚本新手，我无法识别代码中的确切错误！

如果我从终端运行脚本，第一个是日志屏幕截图。如果我从 Xcode 运行脚本，第二个是日志屏幕截图。