Docset Viewer update v1.5

The past year has been quite a ride, to say the least! I have been so busy with work, creating awesome features and technologies on iOS apps that over a year has raced by without an update to my blog!

I’ve also been neglecting my own apps due to being so overwhelmed with the requirements of my work as the lead developer for Salesforce.com’s iOS Chatter app, so it wasn’t until recently that I updated Docset Viewer to add support for iOS 7.  I’ve adapted the design to fit more in line with iOS7, while still providing the same experience as before on iOS6 and earlier.

In addition to iOS 7, I’ve added support for full-screen mode in landscape on iPad, hiding the sidebar.  I also added search term highlighting in search results to make it easier to find the matching text you’re looking for.

iOS7 and OSX 10.9 Docsets

Normally whenever a new release of iOS or OSX comes out, I add support for downloading the documentation for it right within the app.  This is done using an Atom feed which contains information about the version, size, and URL of the compressed documentation archive.

Starting with iOS7 and OSX 10.9, Apple is restricting access to this Atom feed to allow only Xcode access.  You can try it yourself, try and fetch the following URL using your browser or the command-line:  http://developer.apple.com/rss/com.apple.adc.documentation.AppleiPhone7.0.atom

Compare that with the previous iPhone6.0 URL, and you’ll see that they’re trying to force users into using Xcode’s new documentation browser instead of allowing 3rd-party access.

Manually adding docset

It’s still possible to add the iOS 7 and OSX 10.9 documentation to your iPad though.  You simply download the documentation with Xcode, zip the docset directory, and drag it into Docset Viewer from within iTunes or using WebDAV.

In Finder, click Go -> Go to Folder (⇧⌘G) and open the folder:

~/Library/Developer/Shared/Documentation/DocSets

Select the documentation directory that ends in “.docset” that you want to add to your device and create a zip file from it.  Once the zip file is finished being created, you can add that to your device using iTunes or by following the instructions in the app to transfer the file using WebDAV.

I’m going to continue finding a solution to work around Apple’s restrictions, if I can, to hopefully improve this experience.

Update Nov 25, 2013: Docset Viewer v1.5.1 was just released which fixes a crash related to manually loading iOS7 docsets.

About Michael Nachbaur

iOS app developer, livin' the dream. Working from wherever I find myself; Hawaii, Santa Monica, Vancouver, and elsewhere.

4 Responses to “Docset Viewer update v1.5”

  1. Dmytro November 18, 2013 3:17 pm
    #

    It didn’t really work for me. At least for the version I have built from the code on github https://github.com/omz/DocSets-for-iOS
    The docset bundle gets recognised by the app but index of the docset is empty.

    • Michael Nachbaur November 18, 2013 5:22 pm
      #

      First of all, that code on Github is not my application. That is an open-source competitor to Docset Viewer, and has much less features and functionality than Docset Viewer.

      Second, if you download and install my app on your device, then you can either transfer the file over using iTunes file sharing, WebDAV, and other methods convenient to you. In fact, if you add the docsets to one device, you can share them to other devices using Bonjour.

      All applications that read Apple documentation will have this problem due to Apple locking down their atom feed.

  2. Marco Almeida November 21, 2013 11:00 am
    #

    Hi there Mike!! Just came to say that your Docset Viewer app crashes when I try to see the iOS 7 Docset. If I click the Info button it shows me the details of the Docset, but if I click on it to see, bammmmm crashes.

    • Michael Nachbaur November 25, 2013 8:51 pm
      #

      I released a bug fix version of the app, v1.5.1, which fixes this crash. My apologies! It’s available on the app store now.