How to put help book in Xcode project?

Question

Luca_65 OP

Created Jun ’22

Replies 2

Boosts 1

Participants 2

I added in the Xcode project:

<my App>/
    Resources/
        <my App>.help/
            Content/
                Info.plist
                Resources/
                    search.helpindex /*localized */
                    index.html       /*localized */
                    Page1.html       /*localized */

And, in the Project's Info.plist:

	<key>CFBundleHelpBookFolder</key>
	<string><my App>.help</string>
	<key>CFBundleHelpBookName</key>
<string><project' bundle id>.help</string>

But when I archive it, the book help has been moved:

<my App>/
   Content/
        Resources/
            Info.plist
                en.lproj/
                    search.helpindex
                    index.html
                    Page1.htm

So the help book, as is, is missing.

If I manually move the files and folders in the Package to reconstruct the help book structure, it works.

What I have to do in Xcode to let it archive the Help book?

Boost

Answer 1

Luca_65 OP

Jun ’22

On a try I found the solution: In the target / Build Phase / Copy Bundle Resources there were the files of the help book instead to the help book itself. I removed them. I removed the whole help book form the Xcode project. I recreated the book help hierarchy directly in the project file system; in the finder, not in Xcode. Finally, in Xcode, I added ("Add files to ...") the help book. This was recognised by Xcode as a bundle and added in the "Copy Bundle Resources" of the target.

0

Answer 2

konradedgar OP

6d

Would you be able to post the full structure of your Xcode project? Following the documentation, I would think that you would need to put your localised help within folders with specific names corresponding to the available localisations, as below

0