*This page
applies to **Apigee** and **Apigee hybrid**.*
*View [Apigee Edge](https://docs.apigee.com/api-platform/get-started/what-apigee-edge) documentation.*
Before you [test APIs](https://docs.cloud.google.com/apigee/docs/api-platform/local-development/vscode/test), you may need to build a set of test resources, such as API products, developers, or apps, that represent those same resources that might exist in the production environment in your Apigee organization.
Build and export test resources as described in the following sections. See also [Manage folders and files in an Apigee workspace](https://docs.cloud.google.com/apigee/docs/api-platform/local-development/vscode/manage-apigee-workspace#manage-folders-files).
> [!NOTE]
> **Before you begin:** Familiarize yourself with the concepts described in the following topics:
>
> - [What is an API product?](https://docs.cloud.google.com/apigee/docs/api-platform/publish/what-api-product)
> - [Registering app developers](https://docs.cloud.google.com/apigee/docs/api-platform/publish/adding-developers-your-api-product)
> - [Controlling access to your APIs by registering apps](https://docs.cloud.google.com/apigee/docs/api-platform/publish/creating-apps-surface-your-api)
> - [Using key value maps](https://docs.cloud.google.com/apigee/docs/api-platform/cache/key-value-maps)
## Build test resources
To build test resources, [create a test bundle](https://docs.cloud.google.com/apigee/docs/api-platform/local-development/vscode/build-test-resources#create) and edit the test resources defined in the following table.
| Test resource | Description |
|---|---|
| [API products (`products.json`)](https://docs.cloud.google.com/apigee/docs/api-platform/local-development/vscode/build-test-resources#api-products) | Define the API products used to bundle APIs and make them available to developers. |
| [Developers (`developers.json`)](https://docs.cloud.google.com/apigee/docs/api-platform/local-development/vscode/build-test-resources#developers) | Register the developers that will access your APIs. |
| [Developer apps (`developerapps.json`)](https://docs.cloud.google.com/apigee/docs/api-platform/local-development/vscode/build-test-resources#developer-apps) | Register apps to control access to your APIs. |
| [Key value maps (`maps.json`)](https://docs.cloud.google.com/apigee/docs/api-platform/local-development/vscode/build-test-resources#maps) | Define the key value maps (KVMs) used by your APIs to store data for retrieval at runtime. |
### Create a test bundle
To create a test bundle in Cloud Code:
1. Perform one of the following actions:
- Position your cursor over the **test data** folder in your Apigee workspace and click .
- Select **View \> Command Palette** to open the Command palette and select **Cloud Code: Create Apigee test bundle**.
2. Enter a unique name for the test bundle and press Enter.
The test bundle is added to the **test data** folder in the Apigee section.
Configure the test resources, as described in the following sections.
### Define API products (products.json)
Define the API products used to bundle APIs and make them available to developers. For more information about API products, see [What is an API product?](https://docs.cloud.google.com/apigee/docs/api-platform/publish/what-api-product)
To define API products, update the `products.json` file using the configuration wizard or by [editing](https://docs.cloud.google.com/apigee/docs/api-platform/local-development/vscode/manage-apigee-workspace#edit) the `products.json` configuration file directly. For a description of the fields in the `products.json` file, see [Resource: ApiProduct](https://docs.cloud.google.com/apigee/docs/reference/apis/apigee/rest/v1/organizations.apiproducts).
To define API products using the configuration wizard:
1. Position your cursor over the **products.json** file for the test bundle and click .
The **Create API product** wizard opens.
2. Enter a name for the API product and step through the configuration wizard to autopopulate fields in the `products.json` file.
The **`products.json`** file is opened in the editor.
3. Edit the configuration information, as required.
4. Select **File \> Save** or ⌘S to save your edits.
The following example defines the `myapiproduct` API product that contains the `helloworld` API proxy.
```
[
{
"apiResources": [
"/",
"/*",
"/**"
],
"quota": "100",
"quotaInterval": "1",
"quotaTimeUnit": "minute",
"name": "myapiproduct",
"displayName": "My first API product",
"proxies": [
"helloworld"
]
}
]
```
### Register developers (developers.json)
Register the developers that will access your APIs. For more information about developers, see [Registering app developers](https://docs.cloud.google.com/apigee/docs/api-platform/publish/adding-developers-your-api-product).
To register developers, update the `developers.json` file using the configuration wizard or by [editing](https://docs.cloud.google.com/apigee/docs/api-platform/local-development/vscode/manage-apigee-workspace#edit) the `developers.json` configuration file directly. For a description of the fields in the `developers.json` file, see [Resource: Developer](https://docs.cloud.google.com/apigee/docs/reference/apis/apigee/rest/v1/organizations.developers).
To register developers using the configuration wizard:
1. Position your cursor over the **developers.json** file for the test bundle and click .
2. Enter the developer email and other values in the configuration wizard to autopopulate fields in the `developers.json` file. The **`developers.json`** file is opened in the editor.
3. Edit the configuration, as required.
4. Select **File \> Save** or ⌘S to save your edits.
The following example defines the developer `ahamilton@example.com`:
```
[
{
"email": "ahamilton@example.com",
"userName": "ahamilton",
"firstName": "Alex",
"lastName": "Hamilton"
}
]
```
### Register developer apps (developerapps.json)
Register developer apps to control access to your APIs. For more information about registering developer apps, see [Controlling access to your APIs by registering apps](https://docs.cloud.google.com/apigee/docs/api-platform/publish/creating-apps-surface-your-api).
> [!NOTE]
> **Note** : We recommend that you [define API products](https://docs.cloud.google.com/apigee/docs/api-platform/local-development/vscode/build-test-resources#defining_api_products_productsjson) and [register developers](https://docs.cloud.google.com/apigee/docs/api-platform/local-development/vscode/build-test-resources#developers) before you register a developer app.
To register developers apps, update the `developerapps.json` file using the configuration wizard or by [editing](https://docs.cloud.google.com/apigee/docs/api-platform/local-development/vscode/manage-apigee-workspace#edit) the `developerapps.json` configuration file directly. For a description of the fields in the `developerapps.json` file, see [Resource: DeveloperApp](https://docs.cloud.google.com/apigee/docs/reference/apis/apigee/rest/v1/organizations.developers.apps).
To register developer apps using the configuration wizard:
1. Position your cursor over the **developerapps.json** file for the test bundle and click .
2. Select the developer and other values to autopopulate fields in the `developerapps.json` file.
The **`developerapps.json`** file is opened in the editor.
3. Edit the configuration, as required.
4. Select **File \> Save** or ⌘S to save your edits.
The following example registers the developer app `myapp` for `ahamilton@example.com` and associates `myproduct`:
```
[
{
"attributes": [
{
"name": "sample_attribute_0",
"value": "sample_attribute_value_0"
}
],
"developerEmail": "ahamilton@example.com",
"name": "myapp",
"callbackUrl": "",
"keyExpiresIn": "",
"apiProducts": [
"myproduct"
]
}
]
```
### Define key value maps (maps.json)
Define the key value maps (KVMs) used by your APIs to store data for retrieval at runtime. For more information about KVMs, see [Using key value maps](https://docs.cloud.google.com/apigee/docs/api-platform/cache/key-value-maps).
To define key value maps, update the `maps.json` file using the configuration wizard or by [editing](https://docs.cloud.google.com/apigee/docs/api-platform/local-development/vscode/manage-apigee-workspace#edit) the `maps.json` configuration file directly. For a description of the fields in the `maps.json` file, see [KeyValueMap resource](https://docs.cloud.google.com/apigee/docs/reference/apis/apigee/rest/v1/organizations.keyvaluemaps).
To define KVMs using the configuration wizard:
1. Position your cursor over the **maps.json** file for the test bundle and click .
2. Select the scope and other values to autopopulate fields in the `maps.json` file. The **`maps.json`** file is opened in the editor.
3. Edit the configuration, as required.
4. Select **File \> Save** or ⌘S to save your edits.
The following example defines the `mykvm` encrypted KVM:
```
[
{
"name": "mykvm",
"encrypted": true
}
]
```
## Export test resources to the Apigee Emulator
To export the test resources to the Apigee Emulator:
1. Position the cursor over the test bundle that you want to export and click .
2. If multiple [containers for the Apigee Emulator](https://docs.cloud.google.com/apigee/docs/api-platform/local-development/vscode/manage-apigee-emulator#add-container) are running, select the container to which you want to deploy the environment.
The active test resources appear in the Apigee Emulator, as shown in the following figure.
View the test resource contents to obtain specific resource information, such as an [API key](https://docs.cloud.google.com/apigee/docs/api-platform/local-development/vscode/test#apikey) for testing which is generated automatically and included in the developer app test resource.