向Cocoa应用程序添加帮助

Question

我想为我的Cocoa应用程序添加一个简单的单页HTML页面帮助。你能告诉我怎么做吗？我假设我只需要在Xcode的Cocoa项目中放入一个糟糕的.html文件（也许是一个.css文件？）？

Answer 1

创建在帮助查看器中打开的Apple帮助文档非常简单，但您必须完全按照文档中的说明进行操作。

帮助文件是HTML，但您需要在页面中放置几个​​特殊标记并以特定方式命名这些文件。

全部解释于the documentation。

Answer 2

如果您只想要一个HTML页面而不是正确的帮助文件，则可以将HTML文档和CSS文件添加到您的项目中。这些将在您编译项目时复制到应用程序包内的应用程序Resources目录中。要加载文档，您需要获取它的地址。这其实很简单：

NSString *helpFilePath = [[NSBundle mainBundle] pathForResource:@"YourHelpDocumentHere" ofType:@"html"]; 
NSURL *helpFileURL = [NSURL fileURLWithPath:helpFilePath]; 

生成的URL将是一个WebView可以在你的应用程序中显示文件的URL，或者您也可以使用NSWorkspace将其传递给操作系统，它会在用户打开默认网页浏览器。

Answer 3

今天我一直在面对同样的问题。我没有找到最新的howto，所以这里是我自己的。帮助很好地使用这个Step by Step to create Apple Help in your Cocoa Xcode Application。