Cocos SDK Prerequisites

Integrate powerful Web3.0 Cocos SDK in minutes


  • Install Cocos Creator 3.7.2 or later. Earlier versions may also be compatible but will not be actively supported.
  • (iOS only) Install the following:
    • Xcode 14.1 or higher
    • CocoaPods 1.11.0 or higher
  • Make sure that your Unity project meets these requirements:
    • For iOS — targets iOS 14 or higher
    • For Android — Minimum API Level 23 or higher, Targets API level 31 or higher, Pack apk must be with exporting project to Android Studio, change Java SDK version to 11

Create a Particle Project and App

Before you can add our Auth Service to your Cocos game, you need to create a Particle project to connect to your iOS and Android app. Visit Particle Dashboard to learn more about Particle projects and apps.

Import Cocos package

  1. 1.
    Copy assets/Mobile/Core into your project, put it in the assets directory.
  2. 2.
    Copy native/engine folder into your project, put it in the native directory.

Android, Native Service Config

Android — Configuration file path is $exportDir/proj/
# replace your project id
PN_PROJECT_ID = 77eeb8ec-dd64-48e9-b786-aa340ce42a40
#replace your client key
#replace your app id
PN_APP_ID = 96ad2ff1-4a57-4069-90da-9306bf1492e1


  • Configure Xcode project after iOS build.
  1. 1.
    Create a Podfile if you don't already have one. From the root of your Xcode project directory, run the following command:
    pod init
  2. 2.
    Clear the contents of the Podfile, and paste the following code into it. If you have integrated other native SDKs through CocoaPods, you only need to update the original Podfile and add our SDK declaration under the main app.,
    ENV['SWIFT_VERSION'] = '5'
    platform :ios, '14.0'
    source ''
    target 'boost_container' do
    target 'cocos_engine' do
    target 'ParticleCocosDemo-mobile' do
    # Auth SDK
    pod 'ParticleAuthService'
    pod 'ParticleNetworkBase'
    post_install do |installer|
    installer.pods_project.targets.each do |target|
    target.build_configurations.each do |config|
    config.build_settings['BUILD_LIBRARY_FOR_DISTRIBUTION'] = 'YES'
  3. 3.
    Install the pods, then open your .xcworkspace file to see the project in Xcode:
    pod install --repo-update
    open your-project.xcworkspace
  • Configure Project information.
  1. 1.
    Create a ParticleNetwork-Info.plist into the root of your Xcode project
  2. 2.
    Copy the following text into this file:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "">
<plist version="1.0">
3. Replace YOUR_PROJECT_UUID, YOUR_PROJECT_CLIENT_KEY, and YOUR_PROJECT_APP_UUID with the new values created in your Dashboard.
4. Drag the following files into your project and set the Target as the main app.
Make sure Base58.swift, Model.swift and ParticleAuthPlugin.swift TargetMemberShip is selected your app, If Xcode asks whether to create a Swift bridging file, click "Yes".
5.In AppDelegate, add these code in (BOOL)application:openURL:options:method.
- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options {
return [ParticleAuthSchemeManager handleUrl:url];
and add import file in top of file
// for example, our demo project name is ParticleCocosDemo_mobile
// so we import like this.
#import "ParticleCocosDemo_mobile-Swift.h"
// if your project name is MyCocosGame, your need import your project name like this
#import "MyCocosGame-Swift.h"
6.JsbBridgeTest.m and JsbBridgeTest.h files are very important as they are the core of bridging JS and native code. Please ensure that the code inside them is consistent with the demo or contains the code from the demo.
7. Configure your app scheme URL, select your app from TARGETS, under Info section, click + to add the URL types, and paste your scheme in URL Schemes
Your scheme URL should be "pn" + your project app uuid.
For example, if your project app id is "63bfa427-cf5f-4742-9ff1-e8f5a1b9828f", your scheme URL is "pn63bfa427-cf5f-4742-9ff1-e8f5a1b9828f".
Config scheme url
8 Edit Podfile, you should follow Podfile required to edit Podfile.


Cocos Creator



Last modified 2mo ago