Mailing Lists: Apple Mailing Lists

Image of Mac OS face in stamp
 
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Showing Help



Will Lowe wrote:

>3) Add
><key>CFBundleHelpBookFolder</key><string>Thing Help</string>
><key>CFBundleHelpBookName</key><string>Thing Help</string>
>
>to Thing.app/Contents/Info.plist FYI, the CFBundleDevelopmentRegion is set
>to English, presumably by the JarBundler when Thing.app was originally
>created.
>
>4) Open the application:
>  open Thing.app
>
>Thing works as nicely as ever, but with no sign of any online help.

1) Make sure you have a unique CFBundleIdentifier key:
  <http://developer.apple.com/qa/qa2001/qa1022.html>

2) Launch Services, which the 'open' command calls on, caches some
Info.plist contents.  You have to convince LS to update its cache.  I think
this will work:
  touch /path/to/Thing.app

to "modify" the dir representing the app.  It that doesn't work, use Finder
to move Thing.app to another folder, then back (when it's not running).
Then launch it again.


You may also need to put a "Thing Help" folder with the root HTML file in
ALL the language .lproj dirs.  I vaguely recall that omitting things across
languages can defeat some automagical features, but I don't recall if Help
Books suffers from this.


If you can't get anything else to work:
  "You can also place your help book at one of the standard locations for
  third-party help, /Library/Documentation/Help or Library/Documentation/Help
  in the user's home directory. If you place your help at one of these
  locations, you do not need to register your help book."

Ref:
<http://developer.apple.com/documentation/Carbon/Conceptual/ProvidingUserAssitAp
pleHelp/registering_help/chapter_4_section_2.html>


Another trick I've used is to exec() this:
  open /path/to/My.app/Contents/Resources/MyHelp/index.help

which opens the page in HelpViewer because the suffix ".help" binds by
default to HelpViewer.

However, I've also used the CFBundleHelpBook* keys successfully, so
double-check your spelling and case-ness and so on before giving up
entirely on them.  Also, check your app against a native app whose Help
works, mirroring as much of its internal anatomy as you can.

  -- GG


 _______________________________________________
Do not post admin requests to the list. They will be ignored.
Java-dev mailing list      (email@hidden)
Help/Unsubscribe/Update your Subscription:
http://lists.apple.com/mailman/options/java-dev/email@hidden

This email sent to email@hidden



Visit the Apple Store online or at retail locations.
1-800-MY-APPLE

Contact Apple | Terms of Use | Privacy Policy

Copyright © 2007 Apple Inc. All rights reserved.