diff --git a/Docs/MoltenVK_Runtime_UserGuide.md b/Docs/MoltenVK_Runtime_UserGuide.md index 9bd6595a..fda196e8 100644 --- a/Docs/MoltenVK_Runtime_UserGuide.md +++ b/Docs/MoltenVK_Runtime_UserGuide.md @@ -106,6 +106,11 @@ Depending on your build and deployment needs, you can install **MoltenVK** as a *static library*, or *dynamic library*, by following the steps in this section. If you are unsure about which linking and deployment option you need, follow the steps for installing a *static framework*, as it is the simplest to install. + +>**_Note:_** Distributing an app containing a dynamic library via the *iOS App Store* can require +specialized bundling. Unless you have specific needs for dynamic libraries, the recommended +approach on *iOS* is to link **MoltenVK** to your app as a static library. + 1. Open your application in *Xcode* and select your application's target in the *Project Navigator* panel. @@ -168,7 +173,6 @@ about which linking and deployment option you need, follow the steps for install - `UIKit.framework` (*iOS*) - `IOSurface.framework` (*macOS*, or *iOS* if `IPHONEOS_DEPLOYMENT_TARGET` is at least `iOS 11.0`) - 6. If installing **MoltenVK** as a *dynamic library* in your application, arrange to install the `libMoltenVK.dylib` file in your application environment: diff --git a/Docs/Whats_New.md b/Docs/Whats_New.md index 18255ef7..d965cff7 100644 --- a/Docs/Whats_New.md +++ b/Docs/Whats_New.md @@ -19,7 +19,8 @@ MoltenVK 1.0.38 Released TBD -- Add request for feedback from people who reject MoltenVK to README.md document. +- Clarify static linking as the recommended linking approach for *iOS* app store distribution. +- Add request for feedback from people who reject **MoltenVK** to `README.md` document.