openApp(with URL)

2025-03-27 07:44

The openApp(with URL) API is called by the super app to open a mini program with its scheme URL.

Method signature

copy
func openApp(withUrl urlStr: String, startupParams: GRVStartupParams?) throws -> UIViewController?

Parameters

Parameter

Data Type

Required

Description

urlStr

String

Yes

The scheme URL of the mini program. The URL should use the HTTP or HTTPs protocols and include the _ariver_appid, _ariver_path, and _ariver_version query string parameters. You can get the URL from the Mini Program Platform console.

startupParams

GRVStartupParams class

Yes

This parameter is used to pass startup parameters to the IAPMini Program SDK to customize the behavior of the mini program during startup. For how to specify startup parameters, see GRVStartupParams class.

Structures

GRVStartupParams class

This class contains the startup parameters passed to the IAPMiniProgram SDK to customize the behavior of the applet when it is started.

Sample codes:

copy
let param = GRVStartupParams()
param.showTitleBar = false

Error codes

Error code	Error message	Further action
90002	GRV_CONTAINER_API_ERROR_PARAM	The parameter is wrong. Refer to the Parameters table and check whether all parameter types are correct and whether all required parameters are specified.
90003	GRV_CONTAINER_NOT_INITIALIZED	IAPMiniProgram SDK is not initialized. Need to initialize the SDK.
10000	Unknown Error	Please check whether the calling method and parameters are correct. If the problem persists, please contact overseas_support@service.alibaba.com for assistance.

Samples

copy
let startupParams = GRVStartupParams()
startupParams.showTitleBar = true

do {
    let viewController = try GRVAppContainerLaunch.sharedInstance().openApp(withUrl: url, startupParams: startupParams)
    let navigationController = self.navigationController ?? UIApplication.shared.windows.first?.rootViewController as? UINavigationController
    navigationController?.pushViewController(viewController, animated: true)   
} catch {
    print("error:\(error)")
}