Debug for Native Platform
Install Cocos-Debug VS Code Extension
First download Cocos Debug VS Code extension and extract
cocos-debug folder to the
.vscode/extensions folder under user profile folder. Then let's launch VS Code.
Once the Cocos Debug extension is loaded. Click the Debug tab on the left sidebar and then click the gear icon to select
Cocos-JSB debug setting.
If you have trouble loading VS Code extension, please check out the Install Extension doc on VS Code website。
First run your game in Simulator, then find the project root under the simulator install location. This path differs according to your system:
On Mac you can't choose folder inside an app package in VS Code's open folder dialog, you'll have to open VS Code with no active project, then drag the folder above from Finder to VS Code window.
src/project.dev.js in the project, and you can add breakpoint as you wish. Switch to Debug tab in VS Code, choose
Cocos-Debug from the gear menu, then click the green play button to start debug process.
Now you should be able to debug your JSB program on native platform. If anything goes wrong feel free to give us feedback on cocos forum.
For more detail information about VS Code debugging features, please read VS Code Debugging Guide.
Windows socket connect error
Launch debugger on Windows may get the following error in VS Code Debug console:
ar: attachRequest: retry socket.connect
Here's a possible solution: click the gear button in Debug view, and update
launch.json to change the value of
Due to some unknown reason on Windows some debug connection will try to use IPv6 first. So we need to fillin the local machine IP address in IPv6 format.
Debug Built Native Project
Once you build the project for iOS, Android, Windows or Mac, you can debug these native projects with VS Code. Open the project in VS Code, usually the path is:
myProject/build/myProject/jsb-link, depending on your build template.
Once you run the project on the target device or desktop simulator, the workflow is pretty much the same as above, please add your breakpoints in
jsb-default/src/project.dev.js. Below are tips for debugging on mobile platform.
If you want to debug on iOS devices, you should:
- Connect iOS device to Mac via USB cable
- Run cocos2d-x JSB program on iOS devices
- Use IP address of the iOS device to fill the address section in launch.json
If you want to debug on Android devices, you should:
- Connect Android devices with PC via USB cable
- Run cocos2d-x JSB program on Android devices
- Use adb to forward tcp
adb forward tcp:5086 tcp:5086
Currently VSCode82 can only attach to cocos2d-x JSB program to debug. Which means it can not pause on entry. We will improve it in future.