Configure MaestroKit
MaestroKit must be configured at application launch to ensure that all SDK components work correctly. This involves setting up key parameters like your Site ID, JWT token, and specifying the environment. In this chapter, we explore how to instantiate MaestroKit and detail the configuration parameters.
Instantiating MaestroKit
MaestroKit utilizes a singleton pattern through the MaestroManager.shared instance. To configure the SDK, simply call its configure method:
MaestroManager.shared.configure(siteID: "your_site_id", jwt: "your_jwt_token")
This call sets up the necessary parameters for the SDK to operate, including authenticating network requests and managing internal state.
Configuration Parameters
The following table summarizes the configuration parameters required by MaestroKit:
| Parameter | Type | Description | Example |
|---|---|---|---|
siteID | String | A unique identifier for your Maestro site. It must be provided at launch. | "exampleSiteID" |
jwt | String (optional) | A JWT token used for authentication with MaestroKit services. | "exampleJWTToken" |
Environment Setup
MaestroKit’s internal NetworkManager is initialized with an environment setting that dictates the API endpoints and other configurations. By default, MaestroKit is set to use the development environment. Here are the common environment settings:
| Environment | Description |
|---|---|
.development | For testing and development purposes. |
.production | For live applications in production. |
If provided, ensure that the credentials (Site ID and JWT) you provide correspond to the chosen environment.