中

Create Application

This guide walks you through creating and managing applications in the OpenDev platform.

Overview

Applications in OpenDev represent your software projects. Each application gets:

  • Unique App ID for identification
  • App Secrets for authentication (per environment)
  • Dedicated configuration management
  • Channel and product bindings

Prerequisites

Step 1: Access Applications Page

  1. Log in to OpenDev Platform
  2. Click Apps in the sidebar navigation
  3. You'll see the applications list page

Step 2: Create New Application

  1. Click the Create App button in the top right
  2. Fill in the application details:
Field Required Description
App Name Yes Display name for your application
App ID Auto Unique identifier (auto-generated or custom)
Platform Yes Target platforms (iOS, Android, Web, Desktop)
Description No Brief description of the app
App Logo No Application icon (max 1MB)

App ID Guidelines

  • Auto-generated: app_xxxxxxxxxxxx
  • Custom: Must be unique, alphanumeric with underscores
  • Cannot be changed after creation
  1. Click Create to save

Step 3: Application Created

After creation, you'll see:

  • App ID: Your unique application identifier
  • App Secrets: Authentication keys (per environment)
  • Created Date: When the app was created

App Secrets

App secrets are generated for each environment:

Environment Usage
Development Local development and testing
Testing QA and staging environments
Production Live production environment

Security: Keep App Secrets secure. They authenticate your app's API requests.

Managing Applications

View Application Details

  1. In the Apps list, click on an application name
  2. You'll be taken to the Application Details page
  3. Navigate using the tabs:
  • Basic Info: General settings
  • Channels: Channel bindings
  • Products: Product configurations
  • Payment: Payment settings
  • Config Packages: Configuration downloads

Edit Application

  1. Go to Application Details
  2. In the Basic Info tab, click Edit
  3. Modify the editable fields:
  • App Name
  • Description
  • App Logo
  • Platform selection
  1. Click Save Changes

Regenerate App Secret

If you need to regenerate an App Secret:

  1. Go to Application Details > Basic Info
  2. Find the environment's secret
  3. Click the regenerate icon
  4. Confirm the action

Warning: Regenerating secrets will invalidate the old secret immediately.

Delete Application

  1. Go to Application Details
  2. Click the Delete button
  3. Confirm the deletion

Caution: Deletion is permanent and removes all associated configurations.

Application Configuration

Basic Information

Setting Description
Name Display name shown in dashboard
App ID Unique identifier for API calls
Platform Supported platforms
Logo Visual identifier
Description Internal notes

Environment Settings

Each environment (dev/test/prod) has:

  • Separate App Secret
  • Independent configuration packages
  • Isolated channel bindings (optional)

Best Practices

Naming Conventions

Good:
- myapp_prod
- com.company.appname
- game_v2

Avoid:
- test (too generic)
- app1 (not descriptive)
- my-app (use underscores)

Logo Guidelines

  • Format: PNG, JPG, or SVG
  • Size: 512x512 pixels recommended
  • Max file size: 1MB
  • Use transparent background for best results

Security Recommendations

  1. Separate environments - Use different secrets for dev/test/prod
  2. Rotate secrets - Periodically regenerate production secrets
  3. Access control - Limit who can manage production apps
  4. Audit changes - Monitor application modifications

Integration Example

After creating your application, use the credentials in your app:

Backend Configuration

// config.js
module.exports = {
  appId: 'app_xxxxxxxxxxxx',
  appSecret: process.env.APP_SECRET, // From environment variable
  environment: process.env.NODE_ENV || 'development',
};

API Authentication

// Include in API requests
const headers = {
  'X-App-ID': config.appId,
  'X-App-Secret': config.appSecret,
};

Next Steps

After creating your application:

  1. Configure Channels - Set up OAuth and distribution channels
  2. Add Product Tiers - Define your pricing and products
  3. Configure Payments - Enable payment processing
  4. Generate Config Package - Download client configuration

Troubleshooting

Cannot Create Application

Possible causes:

  • Insufficient permissions (need Developer role or higher)
  • Duplicate App ID
  • Invalid characters in App ID

App Secret Not Working

Solutions:

  • Verify you're using the correct environment's secret
  • Check secret hasn't been regenerated
  • Ensure secret is properly URL-encoded if needed

Logo Upload Fails

Solutions:

  • Check file size (max 1MB)
  • Verify format (PNG, JPG, SVG)
  • Ensure stable internet connection