The Arcane World Of Xcode 6.0 Downloadable DocSets: Part Three — Xcode 6.0.1 And The Invisible iOS 8.0 Documentation

If you download the iOS 8.0 documentation via the Downloads tab of the Preferences panel in Xcode 6.0.1 you end up with a package

    com.apple.adc.documentation.AppleiOS8.0.iOSLibrary.docset

and the files

    Library/Receipts/com.apple.pkg.7.0.iOSDocset.bom

and

    Library/Receipts/com.apple.pkg.7.0.iOSDocset.plist

in the directory

   ~/Library/Developer/Shared/Documentation/DocSets

What you don't end up with is any visible iOS 8.0 documentation if you are offline.

The com.apple.pkg.7.0.iOSDocset.plist file in the

   ~/Library/Developer/Shared/Documentation/DocSets/Library/Receipts

directory looks like this

    {
      "InstallPrefixPath" => "/"
      "PackageFileName" => "iOSDocset.pkg"
      "InstallDate" => 2014-09-18 11:05:09 +0000
      "PackageIdentifier" => "com.apple.pkg.7.0.iOSDocset"
      "PackageVersion" => "10.9.0.0.1.1405962775"
      "PackageGroups" => [
        0 => "com.apple.snowleopard-repair-permissions.pkg-group"
        1 => "com.apple.FindSystemFiles.pkg-group"
      ]
      "InstallProcessName" => "Xcode"
    }

Its presence plus the value of the "PackageVersion" entry meets the criteria for installation as expressed in the entry in the .dvtdownloadable index file.

The Downloads tab in the Preferences panel shows the documentation as downloaded, so the part of Xcode responsible for downloads believes the documentation is installed, but the part of Xcode responsible for displaying it does not.

Comparing the info.plist and version.plist files in the Xcode internal documentation set and the downloaded documentation set turns up the interesting fact that the versions don't match.

The internal documentation set has the version number

    52.28

and the downloaded documentation set has the version number

    52.8

So what happens if you make them match ?

Answer the documentation appears when offline.

It works either way round.

You can change the versions in the Info.plist of the downloaded documentation set to 52.28, or the versions in the Info.plist of the internal documentation set to 52.8.

The other issue is the use of

    com.apple.pkg.7.0.iOSDocset

as the package identifier for the iOS 8.0 documentation set.

Although it does not affect the working of Xcode 6.0.1 it effectively de-installs the iOS 7.0 documentation as far as earlier versions of Xcode are concerned.

It should presumably be

    com.apple.pkg.8.0.iOSDocset

---

Copyright (c) 2014 By Simon Lewis. All Rights Reserved.

Unauthorized use and/or duplication of this material without express and written permission from this blog's author and owner Simon Lewis is strictly prohibited.

Excerpts and links may be used, provided that full and clear credit is given to Simon Lewis and justanapplication.wordpress.com with appropriate and specific direction to the original content.

The Arcane World Of Xcode 6.0 Downloadable DocSets: Part One — The com.apple.dt.Xcode Package

Assuming you have Xcode 6.0 installed, then if you look in the directory

    ~/Library/Caches

you will find the package

    com.apple.dt.Xcode

If you look inside the package you will find the directory

    Downloads

and in that directory you should find two files each with the suffix

    .dvtdownloadableindex

Running the file command on either of them will produce the result

    Apple binary property list

You can print the contents of each file using the command

    plutil -p <file>

One file identifies downloadable binaries such as the various iOS Simulators and the other identifies downloadable documentation sets.

It is these files that are used to populate the Components and Documentation sections in the Downloads tab of the Xcode Preferences panel.

This is an example of an entry in the latter file

    ...
    
    33 => {
      "source" => ...
      "dependencies" => [
      ]
      "identifier" => "com.apple.adc.documentation.AppleiOS8.0.iOSLibrary"
      "version" => "52.8"
      "fileSize" => 342039461
      "name" => "iOS 8 library"
      "userInfo" => {
        "InstallPrefix" => "$(HOME)/Library/Developer/Shared/Documentation/DocSets"
        "RequiresADCAuthentication" => 1
        "ActivationPredicate" => "$XCODE_VERSION >= '6.0'"
        "IconType" => "IDEDownloadablesTypeDocSet"
        "Category" => "Documentation"
        "InstalledIfAllReceiptsArePresentOrNewer" => {
          "com.apple.pkg.7.0.iOSDocset" => "10.9.0.0.1.1405962775"
        }
        "Summary" => "My description of content"
      }
   }
   
   ...

It specifies the iOS 8.0 documentation available for download with Xcode 6.0.1.

The entry specifies

• where the documentation can be downloaded from, the "source"field,

• where it should be installed, the "InstallPrefix" field and

• the criteria for deciding whether the documentation is installed, the "InstalledIfAllReceiptsArePresentOrNewer" field.

---

Copyright (c) 2014 By Simon Lewis. All Rights Reserved.

Unauthorized use and/or duplication of this material without express and written permission from this blog’s author and owner Simon Lewis is strictly prohibited.

Excerpts and links may be used, provided that full and clear credit is given to Simon Lewis and justanapplication.wordpress.com with appropriate and specific direction to the original content.