CarPlay documentation

[1ec5]

Classes and methods available only in certain iOS versions are now visible in the jazzy-generated docset. This includes all CarPlay-related symbols, which depend on iOS 12, as well as some symbols related to AVSpeechSynthesizer and Measurement that depend on iOS 10. To make this work, I had to strip out @available attributes. I haven’t fully investigated the root cause of the problem, but it seems to lie somewhere deep in a jazzy improvisation.

Fleshed out documentation of public CarPlay-related symbols and refined their presentation in the docset’s table of contents and cover page. Deleted an old draft of a CarPlay getting started guide.

Added @objc attributes to a number of CarPlay-related symbols to ensure compatibility with Objective-C code.

Fixes #1682.

/cc @mapbox/navigation-ios @mapbox/docs

[1ec5]

For the time being, to get the full docset, you need to:

1. Check out Update last known SDKs to iOS 12 etc. CocoaPods/Xcodeproj#609.
2. Check out Fix error compiling Swift podspec in Xcode 10 realm/jazzy#1004.
3. Point jazzy to your clone of xcodeproj using bundle:

   diff --git a/Gemfile b/Gemfile
   index 9ed00c9..f419f26 100644
   --- a/Gemfile
   +++ b/Gemfile
   @@ -1,5 +1,6 @@
    source 'https://rubygems.org'
    
   +gem "xcodeproj", github: "1ec5/Xcodeproj", branch: "ios12"
    gemspec
    
    group :development do

   bundle config local.xcodeproj /path/to/xcodeproj
   bundle install

4. Point document.sh to your clone of jazzy, as described in Failure generating documentation — Could not parse version component #1682 (comment).
5. Run document.sh like normal. (As of this PR, it requires Bash 4.)

[1ec5]

Doh, didn’t mean to commit this line. Fixed in cecb46e.