requestInlineAppInstallation(_:subjectToken:)

Requests the installation of a web-distributed app that you also distribute.

Declaration

nonisolated final func requestInlineAppInstallation(_ request: AppLibrary.InstallationRequest, subjectToken: String?) async throws

Parameters

request:
An installation request that describes the alternative distribution package URL, account, and install verification token for the app to install.
subjectToken:
An optional authentication token equivalent to the Marketplacekiturischeme token parameter.

Mentioned in

Distributing your app from your website

Discussion

The system verifies that the app to install meets the following requirements:

From the same developer account as the app that calls the method.
Approved for web distribution. For information about the approval process, see Participating in alternative distribution for specific regions.

If the app fails to meet these criteria, the system throws MarketplaceKitError.

If the app meets the criteria, the system presents a sheet that prompts the person to approve the installation. When the person gives their approval, the system proceeds with the installation using the AppLibrary.InstallationRequest you provide and an optional authentication token. If the installation request fails (for example, if your web server doesn’t provide the app) or the person declines the prompt, the method throws MarketplaceKitError.