openApp(with appId)

2025-03-27 07:44

The openApp(with appId) API is called by the super app to open mini programs with appId, the unique ID to identify a mini program.

Method signature

copy
func openApp(withAppId appId: String, startupParams: GRVStartupParams?) throws -> UIViewController?

Parameters

Parameter

Data Type

Required

Description

appId

String

Yes

The unique ID that is assigned by Mini Program Platform to identify a mini program. You can get the ID from the Mini Program Platform console or by fetching mini program information with the fetchApps API.

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 that are passed to the IAPMiniProgram SDK to customize the behavior of the mini program during startup.

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.

Sample

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

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