IAPMiniProgram SDK shows error pages when page opening errors occur in a mini program. The errors fall into the following two types:

• Network or server errors
• Status errors that are caused by invalid statuses of the mini program or the page URL

The super app can customize the error pages according to the error types and display specific error messages according to the error codes.

Customize the error page for network or server errors

This section provides an example of a default error page and instructions to customize the error page for network or server errors.

Default user experience

For network or server errors, the SDK shows a default error page as follows while the error message and error code (which is Failed to open this page -1001 in the example) can vary depending on the specific error encountered.

Procedures

Take the following three steps to customize an error page for network or server errors:

Step 1: Create your custom error page

Create a new HTML file to customize your own error page. You can incorporate the following schematic code to receive and process the necessary information for the customization:

error.html?a=b

The following table shows the information that is passed each time the user encounters a network or server error and your custom error page is accessed:

Step 2: Put the error page in your iOS project

Put your custom error page into your iOS project as shown in the following example:

Note: For network or server errors, you cannot store the error page remotely due to possible network connection errors.

Step 3: Configure GRVExtensionDelegate

Before the SDK initialization logic, configure the GRVExtensionDelegate extension with the following sample code:

let extensionDelegate = GRVExtensionDelegate()
// Designate your own error page path.
extensionDelegate.uiProvider.errorPageURL = Bundle.main.path(forResource: "error", ofType: "html")
config.riverExtensionDelegate = extensionDelegate

Customize the error page for status errors

This section provides an example of a default error page and instructions to customize the error page for status errors.

Default user experience

For status errors, the SDK shows a default error page as follows while the error message (which is The app has been removed. in the example) can vary depending on the specific error encountered. For more information about the default error message, refer to Status errors.

Procedures

Take the following three steps to customize an error page for status errors:

Step 1: Create your custom error page

Create a new HTML file to customize your own error page. You can incorporate the following schematic code to receive and process the necessary information for the customization:

status.error.html?a=b

The following table shows the information that is passed each time the user encounters a status error and your custom error page is accessed:

Step 2: Add the error page

Add the custom error page via either of the following two methods:

• Put the page into your iOS project as shown in the following example:

• Host the page on the CDN service. Make sure the access URL uses an HTTPS scheme as follows:

https://your-server-status_error.html

Step 3: Configure GRVExtensionDelegate

Before the SDK initialization logic, configure the GRVExtensionDelegate extension with the following sample code:

let config = IAPConnectInitConfig()
let extensionDelegate = GRVExtensionDelegate()
// Designate your own status error page path.
extensionDelegate.uiProvider.statusPageURL = Bundle.main.path(forResource: "status_error", ofType: "html")
config.riverExtensionDelegate = extensionDelegate

Appendix

Status errors

The following table shows the details for status errors in mini programs: