8

我已经仔细检查了所有内容，并希望有人能找到我没有看到的愚蠢错误。

我正在尝试为我的应用程序构建一个 Apple 帮助部分，它正确地进入了登录页面，但是没有一个锚点起作用。登录页面被调用index.html，另一个页面被调用，该页面test.html位于pgs目录中。

在 index.html 我有：

<a href="help:anchor=support bookID=com.company.app_name.help">Link to another page</a>

在 test.html 我有：

<a name="support"></a>

所以这是我为了到达现在的位置而遵循的步骤：

1）我建立了Apple文档指定的目录

AppName.help/
    Contents/
        Info.plist
        Resources/
            shrd/
            English.lproj/
                index.html
                search.helpindex
                pgs/
                    test.html

2) 我按照 Apple 文档中的说明构建了 Help Info.plist。包含在 Info.plist 中，我将其设置CFBundleIdentifier为com.company.app_name.help.

3）在我的应用程序 Info.plist 中，我设置CFBundleHelpBookFolder为AppName.help并设置CFBundleHelpBookName为com.company.app_name.help

4) 然后我复制了我在 Xcode 中构建的目录，同时确保选择了Create Folder References for any added folder选项。

5）然后我使用帮助索引器来索引目录AppName.help。确保我选择了在所有文件中索引锚信息的选项。然后我将 .helpindex 文件复制到它应该在的English.lproj文件夹中。

而已。如果我将以下链接放在index.html文件中，我注意到我的应用程序可以正常工作。

<a href="pgs/test.html">Click this link</a>

这也是我的index.html代码：

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd"><html xmlns="http://www.w3.org/1999/xhtml">
<head>
    <title>AppName Help</title>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    <meta name="robots" content="noindex" />
    <meta name="AppleTitle" content="AppName Help" />
    <meta name="AppleIcon" content="../shrd/icon.png" />
</head>
<body>
    <a href="help:anchor=support bookID=com.company.app_name.help">Link to another page</a>
</body>

这是test.html 的代码。

<?xml version="1.0" encoding="utf-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
    <head>
        <title>Testing Links</title>
        <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
        <meta name="robots" content="anchors" />
    </head>
    <body>
        <a name="support"></a>Does linking work?<br/>

    </body>
</html>

这是我的帮助文件的 Info.plist。

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>CFBundleDevelopmentRegion</key>
    <string>en_us</string>
    <key>CFBundleIdentifier</key>
    <string>com.company.app_name.help</string>
    <key>CFBundleInfoDictionaryVersion</key>
    <string>6.0</string>
    <key>CFBundleName</key>
    <string>AppName</string>
    <key>CFBundlePackageType</key>
    <string>BNDL</string>
    <key>CFBundleShortVersionString</key>
    <string>2</string>
    <key>CFBundleSignature</key>
    <string>hbwr</string>
    <key>CFBundleVersion</key>
    <string>2</string>
    <key>CFBundleHelpBookName</key>
    <string>AppName Help</string>
    <key>HPDBookAccessPath</key>
    <string>index.html</string>
    <key>HPDBookIconPath</key>
    <string>shrd/icon.png</string>
    <key>HPDBookIndexPath</key>
    <string>search.helpindex</string>
    <key>HPDBookKBProduct</key>
    <string>app_name1</string>
    <key>HPDBookKBURL</key>
    <string>http://www.company.com</string>
    <key>HPDBookRemoteURL</key>
    <string>http://www.company.com</string>
    <key>HPDBookTitle</key>
    <string>AppName Help</string>
    <key>HPDBookType</key>
    <string>3</string>
</dict>
</plist>

我也关注了这篇文章：http ://www.cocoabuilder.com/archive/cocoa/312037-updating-an-app-help.html除了重新索引目录之外，每次我进行更改时都清除缓存.

谢谢大家！

4

2 回答 2

5

当然大卫，谢谢你的提醒。

根据我的回忆和我草率的文档，我运行以下命令来索引帮助文档文件：

hiutil -vCaf ./search.helpindex English.lproj

然而，我意识到的一件事是索引实用程序会在任何时候使用该&nbsp;字符时抱怨。而是替换字符&#32;

我认为这是我的情况的错误。

于 2013-09-10T21:46:38.217 回答
1

如果一切正常并且如果帮助不起作用，请使用下面的代码。不确定您的安全问题，您可能需要研究从应用程序中删除文件。有时升级时的应用程序不会更新帮助文件并显示旧帮助文件的缓存副本，其中不包含新的锚点。因此下面的代码清除了帮助缓存。还有另一种更简洁的方法，您可以在 Info.plist 中增加帮助文件的构建版本，该文件位于帮助包中，而不是应用程序信息 plist。这些字段是 CFBundleShortVersionString CFBundleVersion 

-(void)clearCacheHelp {
NSArray *arguments1 = [NSArray arrayWithObjects:@"helpd",nil];

NSTask * list1 = [[NSTask alloc] init];
[list1 setLaunchPath:@"/usr/bin/killall"];
[list1 setArguments:arguments1];


NSPipe * out1 = [NSPipe pipe];
[list1 setStandardOutput:out1];

[list1 launch];
[list1 waitUntilExit];


NSString *home = [self homeDirectory];

home = [home stringByAppendingPathComponent:@"Library/Caches/com.apple.helpd"];

NSArray *arguments  = [NSArray arrayWithObjects:@"-rf",home,nil];


NSTask * list = [[NSTask alloc] init];
[list setLaunchPath:@"/bin/rm"];
[list setArguments:arguments];


NSPipe * out = [NSPipe pipe];
[list setStandardOutput:out];

[list launch];
[list waitUntilExit];



NSString *home2 = [self homeDirectory];

home2 = [home2 stringByAppendingPathComponent:@"Library/Caches/com.apple.helpviewer"];

NSArray *arguments2  = [NSArray arrayWithObjects:@"-rf",home2,nil];


NSTask * list2 = [[NSTask alloc] init];
[list2 setLaunchPath:@"/bin/rm"];
[list2 setArguments:arguments2];


NSPipe * out2 = [NSPipe pipe];
[list2 setStandardOutput:out2];

[list2 launch];
[list2 waitUntilExit];


NSArray *arguments3  = [NSArray arrayWithObjects:@"-rf",@"~/Library/Caches/com.apple.helpd",nil];


NSTask * list3 = [[NSTask alloc] init];
[list3 setLaunchPath:@"/bin/rm"];
[list3 setArguments:arguments3];


NSPipe * out3 = [NSPipe pipe];
[list3 setStandardOutput:out3];

[list3 launch];
[list3 waitUntilExit];


NSArray *arguments4  = [NSArray arrayWithObjects:@"-rf",@"~/Library/Caches/com.apple.helpviewer",nil];


NSTask * list4 = [[NSTask alloc] init];
[list4 setLaunchPath:@"/bin/rm"];
[list4 setArguments:arguments4];


NSPipe * out4 = [NSPipe pipe];
[list4 setStandardOutput:out4];

[list4 launch];
[list4 waitUntilExit];


}
于 2015-09-04T14:07:43.313 回答