【问题标题】:Objective-C and Swift Documentation together like Apple documentation [closed]Objective-C 和 Swift 文档就像 Apple 文档一样 [关闭]
【发布时间】:2015-12-02 11:38:01
【问题描述】:

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

一个。氧气

b.苹果文档

c。爵士乐

d。苹果的 HeaderDoc。

我想在我的 Objective-C 头文件中使用 cmets,并为 Objective C 和 Swift 生成组合帮助,类似于 Apple 最近所做的那样。 我的问题是如何从 Objective-C 标头生成 Swift 和 Objective-C 的文档?

以下是根据我的研究得出的一些链接:

谢谢,

内存。

请参考这里的苹果文档:

【问题讨论】:

  • 不清楚你在问什么。您想同时使用 Obj-c 和 swift 构建应用程序吗?那关于文档的内容是什么?为什么你甚至要说“同时支持 obj-c 和 swift”?目标是iOS。它支持两者。这就是全部内容
  • 如果你想在 swift 项目中使用 obj-c 文件,那么你应该阅读这篇文章。 developer.apple.com/library/ios/documentation/Swift/Conceptual/… 。有可能
  • 感谢您的快速回复。我想生成文档集,比如苹果如何记录它的 API,其中包括 Swift 和 Objective-C 的文档。请参考here
  • @NSNoob 让问题更清楚了。
  • Ram 是对的——这在自动生成的文档中会非常有趣,例如在 CocoaPods 中托管的 Objective-C 库。对于本地文档,它也很有趣。几年后,我们将拥有 Objective-c 和 swift 混合体,它们将从这种组合文档中受益。

标签: ios doxygen appledoc apple-documentation


【解决方案1】:

也许(尚未)完全符合您的要求,但您可以使用 Swiftify (https://objectivec2swift.com/) 服务将声明从 Objective-C 转换为 Swift。

此外,如果上述文档工具允许开发任何类型的插件以与之集成,则应该可以使用我们的 Web API 自动生成 Swift 源代码。

如果有需求,我们可能愿意开发这样的集成。

免责声明:我是 Swiftify 的作者 :)

【讨论】:

  • 感谢您的宝贵回复。我试过 Swiftify。它将 Objective-C 代码完美地转换为 Swift,但不是代码文档。但是,正如您提到的,如果有需求,请将我 +1 视为渴望等待该功能。
猜你喜欢
  • 2010-10-23
  • 1970-01-01
  • 1970-01-01
  • 1970-01-01
  • 1970-01-01
  • 2010-10-03
  • 1970-01-01
  • 2014-07-31
  • 2012-06-10
相关资源
最近更新 更多