[ios, macos] Default to local rendering of CJK characters, using system font (#14862)

* Change default CJK font from "PingFang" to "Helvetica"

* Add CHANGELOG.

* Update CHANGELOG.

* [ios] Enable client-side rendering and use `Helvetica` by default. Set `MGLIdeographicFontFamilyName` to `NULL` for using your custom remote font.

* [ios] Update change log

* [ios] Change default CJK configuration in `iosapp` project

* [ios] Update comment

* [ios] return local font name using default system font.

* [ios] Update changelog

* [ios] update changelogs & comments

* [iOS, macOS]Support mac os

* [iOS, macOS] fix bug

* [iOS, macOS] update change log

* [iOS, macOS] fix nit.

* [iOS, macOS] Ability to specify an array of fonts for fallbacks for `localIdeographicFontFamily`

* [iOS, macOS] Update comments

* [iOS, macOS] Update change log

* [iOS, macOS] update for mac OS font family names

* Fix nit.

* Update platform/ios/CHANGELOG.md

Co-Authored-By: Minh Nguyễn <mxn@1ec5.org>

* [iOS, macOS] Set `MGLIdeographicFontFamilyName` to a Boolean value `NO` for using your custom remote font.

* [iOS, macOS] remove `MGLIdeographicFontFamilyName` from info.plist & update Info.plist Keys.md

* [iOS, macOS] remove `MGLIdeographicFontFamilyName` from macOS demo app project and update info.plist Keys.md

* [iOS, macOS] update macOS changelog

* [iOS, macOS] Change docs

* Update Change log

* [iOS, macOS] Test case

* Update platform/macos/docs/guides/Info.plist Keys.md

Co-Authored-By: Jason Wray <friedbunny@users.noreply.github.com>

* Update platform/macos/docs/guides/Info.plist Keys.md

Co-Authored-By: Jason Wray <friedbunny@users.noreply.github.com>

* Update platform/ios/CHANGELOG.md

Co-Authored-By: Jason Wray <friedbunny@users.noreply.github.com>

* Update platform/darwin/src/MGLRendererConfiguration.mm

Co-Authored-By: Jason Wray <friedbunny@users.noreply.github.com>

* Update platform/darwin/test/MGLRendererConfigurationTests.mm

Co-Authored-By: Jason Wray <friedbunny@users.noreply.github.com>

* Update platform/macos/docs/guides/Info.plist Keys.md

Co-Authored-By: Jason Wray <friedbunny@users.noreply.github.com>

* Update platform/macos/docs/guides/Info.plist Keys.md

Co-Authored-By: Jason Wray <friedbunny@users.noreply.github.com>

* Update platform/macos/docs/guides/Info.plist Keys.md

Co-Authored-By: Jason Wray <friedbunny@users.noreply.github.com>

* [iOS, macOS] update comments

* [iOS, macOS] add plist value test && filter for invalid string

* [iOS, macOS] fix nit

* Update platform/ios/docs/guides/Info.plist Keys.md

Co-Authored-By: Jason Wray <friedbunny@users.noreply.github.com>

* Update platform/ios/docs/guides/Info.plist Keys.md

Co-Authored-By: Jason Wray <friedbunny@users.noreply.github.com>

* Update platform/ios/docs/guides/Info.plist Keys.md

Co-Authored-By: Jason Wray <friedbunny@users.noreply.github.com>

* Update platform/macos/CHANGELOG.md

Co-Authored-By: Jason Wray <friedbunny@users.noreply.github.com>

* Update platform/ios/docs/guides/Info.plist Keys.md

Co-Authored-By: Jason Wray <friedbunny@users.noreply.github.com>

* Update platform/ios/docs/guides/Info.plist Keys.md

Co-Authored-By: Jason Wray <friedbunny@users.noreply.github.com>

* [iOS, macOS] add invalid value type test

* Apply own suggestions from code review

3 files changed, 12 insertions, 4 deletions

diff --git a/platform/ios/CHANGELOG.md b/platform/ios/CHANGELOG.md
index 79e96bb84c..82968a2582 100644
--- a/platform/ios/CHANGELOG.md
+++ b/platform/ios/CHANGELOG.md
@@ -4,6 +4,7 @@ Mapbox welcomes participation and contributions from everyone. Please read [CONT
 
 ## master
 
+* The `MGLIdeographicFontFamilyName` Info.plist key now also accepts an array of font family names, to customize font fallback behavior. It can also be set to a Boolean value of `NO` to force the SDK to typeset CJK characters in a remote font specified by `MGLSymbolStyleLayer.textFontNames`. ([#14862](https://github.com/mapbox/mapbox-gl-native/pull/14862))
 * Performance improvements for queryRenderedFeatures API and optimization that allocates containers based on a number of rendered layers. ([#14930](https://github.com/mapbox/mapbox-gl-native/pull/14930))
 * Fixed rendering layers after fill-extrusion regression caused by optimization of fill-extrusion rendering. ([#15065](https://github.com/mapbox/mapbox-gl-native/pull/15065))
 
diff --git a/platform/ios/app/Info.plist b/platform/ios/app/Info.plist
index e2f294a5a5..c302f306a6 100644
--- a/platform/ios/app/Info.plist
+++ b/platform/ios/app/Info.plist
@@ -24,8 +24,6 @@
 	<string>7877</string>
 	<key>LSRequiresIPhoneOS</key>
 	<true/>
-	<key>MGLIdeographicFontFamilyName</key>
-	<string>PingFang TC</string>
 	<key>NSHumanReadableCopyright</key>
 	<string>© 2014–2019 Mapbox</string>
 	<key>NSLocationAlwaysUsageDescription</key>
diff --git a/platform/ios/docs/guides/Info.plist Keys.md b/platform/ios/docs/guides/Info.plist Keys.md
index 97b9d7419e..6322b42dc1 100644
--- a/platform/ios/docs/guides/Info.plist Keys.md
+++ b/platform/ios/docs/guides/Info.plist Keys.md
@@ -22,7 +22,15 @@ If you have implemented custom opt-out of Mapbox Telemetry within the user inter
 
 ## MGLIdeographicFontFamilyName
 
-The name of the font family to use for client-side text rendering of CJK ideographs. Set this to the name of a font family which will be available at run time, e.g. `PingFang TC` (iOS 9+), `Heiti TC` (iOS 8+), another appropriate built-in font, or a font provided by your application. Note that if a non-existent font is specified, iOS will fall back to using Helvetica which is likely not to include support for the glyphs needed to render maps in your application.
+The name of the font family to use for client-side text rendering of CJK ideographs.
+
+Set `MGLIdeographicFontFamilyName` in your containing application's Info.plist to font family name(s) that will be available at run time, such as “PingFang TC” or “Marker Felt”. This plist key accepts:
+
+- A string value of a single font family name.
+
+- An array of font family names. Fonts will be used in the defined order, eventually falling back to default system font if none are available.
+
+- A boolean value `NO` to disable client-side rendering of CJK glyphs — remote fonts specified in your style will be used instead.
 
 ## MGLCollisionBehaviorPre4_0
 
@@ -30,4 +38,5 @@ The name of the font family to use for client-side text rendering of CJK ideogra
 
 Beginning in version 4.0, the SDK also performs collision detection between style layers based on different sources by default. For the default behavior, omit the `MGLCollisionBehaviorPre4_0` key or set it to NO (`false`).
 
-This property may also be set using `[[NSUserDefaults standardUserDefaults] setObject:@(YES) forKey:@"MGLCollisionBehaviorPre4_0"]`; it will override any value specified in the `Info.plist`.
\ No newline at end of file
+This property may also be set using `[[NSUserDefaults standardUserDefaults] setObject:@(YES) forKey:@"MGLCollisionBehaviorPre4_0"]`; it will override any value specified in the `Info.plist`.
+