应用移植开发参考文档
OpenCloudOS V9 应用移植开发文档
本文档旨在指导用户在 OpenCloudOS 系统上完成 Visual Studio Code (VSCode) 和 PyCharm 的安装及基础环境配置
目录
-
VSCode 安装
Visual Studio Code（简称 VSCode）是微软推出的一款支持 Mac OS、Windows 与 Linux 的跨平台源码编辑器，适用于现代 Web 与云应用的开发。
访问 VSCode 官网：下载.rpm 文件,
官网链接https://code.visualstudio.com/。
下载链接：https://code.visualstudio.com/Download#
下载系统对应的 .rpm 文件。
在下载目录打开终端，执行如下命令进行安装：
sudo dnf install code-1.105.1-1760482588.el8.x86_64.rpm
安装完成后，即可在系统开始菜单中找到 VSCode。主界面展示如下：
1. #### VSCode 环境配置
1. ### 安装 C/C++ 插件
通过左侧边栏 Extensions 搜索并安装 C/C++ 插件，安装过程如下图：
1. ### 建立工程
VSCode 以文件夹为粒度管理工程，推荐新建一个项目文件夹，例如 hello，
然后使用 VSCode 打开该文件夹：
新建 main.cpp，编写简单程序：
1. ### 配置调试（launch.json）
点击左侧 Debug，选择 “Add configuration”，选择 “C++ (gdb) Launch”，系统将自动生成 launch.json：
生成的默认配置如下：
生成的默认 json 文件如下：
{
// Use IntelliSense to learn about possible attributes.
// Hover to view descriptions of existing attributes.
// For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
"version": "0.2.0",
"configurations": [
{
"name": "(gdb) Launch",
"type": "cppdbg",
"request": "launch",
"program": "enter program name, for example ${workspaceFolder}/a.out",
"args": [],
"stopAtEntry": false,
"cwd": "${fileDirname}",
"environment": [],
"externalConsole": false,
"MIMode": "gdb",
"setupCommands": [
{
"description": "Enable pretty-printing for gdb",
"text": "-enable-pretty-printing",
"ignoreFailures": true
},
{
"description": "Set Disassembly Flavor to Intel",
"text": "-gdb-set disassembly-flavor intel",
"ignoreFailures": true
}
]
}
]
}
注意:这里需要将 program 项的内容改为调试时运行的程序，将其改为 main.out
即可。具体更改如下：
"program": "enter program name, for example
${workspaceFolder}/a.out",
改为
"program": "${workspaceFolder}/main.out",
该语句指的是当前工作文件夹下的 main.out 文件，更改完毕的 launch.json 文
件见附录。 1. ### 添加构建任务（tasks.json） 为方便编译运行，可将 g++ 命令定义为任务。
使用快捷键 Ctrl+Shift+P，输入 Tasks: Run task，首次执行会提示：
No task to run found. configure tasks...
回车，然后依次选择如下：
Configure a Task
Create tasks.json file from template
Others Example to run an arbitrary external command.
生成默认的 tasks.json 文件如下：
{
// See https://go.microsoft.com/fwlink/?LinkId=733558
// for the documentation about the tasks.json format
"version": "2.0.0",
"tasks": [
{
"label": "echo",
"type": "shell",
"command": "echo Hello"
}
]
}
这里的 label 为任务名，我们将”label"= "echo"改为”label"= "build"。
由于我们的指令是 g++，这里将”command“=”echo Hello“为”command“=”g++“。
然后添加 g++的参数 args。如果我们的 g++指令为：g++ -g main.cpp，这里可
以把参数设置为如下：
{
"tasks": [
{
"label": "build",
"type": "shell",
"command": "g++",
"args": ["-g", "${file}"]
}
]}
如果我们想配置 g++指令为：g++ -g main.cpp -std=c++11 -o main.out，则
参数可设置为：
{
"tasks": [
{
"label": "build",
"type": "shell",
"command": "g++",
"args": ["-g", "${file}", "-std=c++11", "-o",
"${fileBasenameNoExtension}.out"]
}
]}
我们可以通过举一反三来配置不同的 g++指令。完整的 tasks.json 文件可参考
附录。 1. ### 简单断点调试 经过上述配置之后就可以对我们写的程序进行简单的配置。在进行下面的操作
前，我们应当保证 launch.json 和 tasks.json 的正确性并且已经成功保存。
使用快捷键 ctrl+shift+p 调出命令行，输入 Tasks: Run task 选择执行我们的
build 任务,选择 continue without scanning the task output（进入到main.cpp文件页面，再run task），build 成功后，点击开始调试。具体操作如下：
值得注意的是，这里如果每次更改了程序需要重新 build，然后再进行调试；如
果直接进行调试则运行的是上次 build 的结果。通过在 launc.json 作如下更改可以使得每次调试之前会自动进行 build：
这里在 launch.json 文件中添加了”preLaunchTask“=”build"，也就是添加一
个 launch 之间的任务，任务名为 build，这个 build 就是我们在 tasks.json 中设置的任务名。
-
PyCharm 安装
-
下载官方安装包
打开浏览器访问：https://www.jetbrains.com/pycharm/download/?section=linux
找到 Linux 对应安装包并下载。
1. ### 进入下载目录
一般安装包默认保存在 ~/下载/，执行：。
cd ~/下载 1. ### 解压安装包 tar -xvf pycharm-2025.2.4.tar.gz 1. ### 进入解压后的目录 cd pycharm-2025.2.4/
1. ### cd bin/
启动 PyCharm：
./pycharm.sh
运行该命令后，PyCharm 将会启动，并进入初始化配置界面。这一步可能需要一些时间，请耐心等待。
·导入设置：如果之前使用过 PyCharm，可以选择导入原有设置。
·UI 外观设置：选择 PyCharm 的主题（如深色模式或浅色模式）。
·插件安装：可以选择安装一些实用插件，如 Python Docstring、Markdown Support 等。
1. #### Pycharm常用配置
1. ### 添加 PyCharm 至 PATH（可选）
避免反复进入 bin 目录运行：
在设置中勾选 “Add to PATH” 或手动添加。 1. ### 创建桌面快捷方式 编辑配置文件：
nano ~/.local/share/applications/pycharm.desktop
拷贝以下内容到文件里（根据本机情况修改）
Type=Application
Name=PyCharm
GenericName=Python IDE
Comment=PyCharm Professional IDE
Exec=/home/sun/下载/pycharm-2025.2.4/bin/pycharm.sh
Icon=/home/sun/下载/pycharm-2025.2.4/bin/pycharm.png
Terminal=false
Categories=Development;IDE;
StartupNotify=true
更新 GNOME 应用列表：
update-desktop-database ~/.local/share/applications/
刷新后即可在桌面环境看到快捷启动图标。
1. #### 使用 PyCharm 创建 Python 项目
1. ### 创建新项目
打开 PyCharm 后，您将看到一个欢迎界面，点击 "New Project" 按钮创建一个新项目。设置项目位置：选择新项目的存储路径，例如 /home/sun/PycharmProjects/PythonProject。
选择 Python 解释器：PyCharm 支持虚拟环境，您可以选择使用系统的 Python 解释器或者创建新的虚拟环境。建议为每个项目创建独立的虚拟环境以保证项目之间互不干扰。
1. ### 编写第一个 Python 程序
右键项目目录 → New → Python File，命名为：
hello_world.py
编写：
print("Hello, PyCharm!") 1. ### 运行程序 右键运行或点击右上绿色箭头，输出示例：
1. #### 附录
这里给出一个较完整的配置文件和任务文件，该配置仅供参考！
1. ### launch.json
{
// Use IntelliSense to learn about possible attributes.
// Hover to view descriptions of existing attributes.
// For more information, visit:
https://go.microsoft.com/fwlink/?linkid=830387
"version": "0.2.0",
"configurations": [
{
"name": "(gdb) Launch",
"type": "cppdbg",
"request": "launch",
"program":
"${workspaceFolder}/${fileBasenameNoExtension}.out",
"args": [],
"stopAtEntry": false,
"cwd": "${workspaceFolder}",
"environment": [],
"externalConsole": true,
"MIMode": "gdb",
"preLaunchTask": "build",
"setupCommands": [
{
"description": "Enable pretty-printing for gdb",
"text": "-enable-pretty-printing",
"ignoreFailures": true
}
]
}
// See https://go.microsoft.com/fwlink/?LinkId=733558
// for the documentation about the tasks.json format
"version": "2.0.0",
"tasks": [
{
"label": "build",
"type": "shell",
"command": "g++",
"args": ["-g", "${file}", "-std=c++11", "-o",
"${fileBasenameNoExtension}.out"]
}
]}