export default { "title": "cloudcc开发环境搭建教程", "description": "本文档是关于搭建cloudcc开发环境的教程。", "content": ` --------CloudCC 开发环境搭建指南开始-------- # CloudCC 开发环境搭建指南 ## 本指南用于引导用户逐步完成 CloudCC 开发环境的搭建。 ### 答复要求: * 当用户咨询开发环境搭建相关问题时,请遵循本指南内容,逐步引导用户操作,每次仅提供一个步骤,避免一次性给出所有步骤。 * 当用户咨询自定义代码开发等非环境搭建相关问题时,请避免引用本指南内容。 ### 适用范围: * 本指南仅适用于解答 CloudCC 开发环境搭建问题,不适用于其他主题。 ## 搭建步骤 ### 安装 Node.js: 14.19.0(必须使用此版本) 下载链接:http://nodejs.cn/download/ 推荐:使用 nvm(Node 版本管理器)来管理多个 Node.js 版本 ### 包管理器:npm 为加快依赖安装速度,将 npm 注册表切换到阿里巴巴源: npm config set registry https://registry.npmmirror.com ### 全局依赖 npm install -g @vue/cli@5.0.8 npm install -g @vue/cli-service-global@4.5.17 npm install -g cloudcc-cli 检查安装状态,确认这三个包可见: npm ls -g --depth=0 ### 安装 VS Code 下载链接:https://code.visualstudio.com/download ### 安装 CloudCC VS Code 插件:CloudCC。如已安装则忽略此步骤。 ### 创建并运行项目 * cc create project demo1 * 使用 VS Code 打开此项目 * npm i * npm run serve ### 打开 cloudcc-cli.config.js 文件,配置安全标记 #### 公有云配置 "devConsoleConfig": { // CRM 开发者账户 "username": "xxx", // 密钥 "secretKey": "xxx", // 安全标记(通过系统重置安全标记邮件获取) "safetyMark": "xxx", // 注册时获得的客户端 ID "clientId": "xxx", // 注册时获得的密钥 "openSecretKey": "xxx", // 组织 ID "orgId": "xxx" }, * secretKey获取方法 * 国内公有云 API 端点:https://developer.apis.cloudcc.cn/sysconfig/auth/secretkey/get * 全球公有云 API 端点:https://global-gw.cloudcc.com/sysconfig/auth/secretkey/get * 部署为公有云的私有云 API 端点:https://网关地址/systconfig/auth/secretkey/get * 请求方法:POST Content-Type: application/x-www-form-urlencoded 请求体:{"username":"xxx"} curl -H "Content-Type: application/x-www-form-urlencoded" -d "username=cloudcc@xxxx" -X POST https://developer.apis.cloudcc.cn/sysconfig/auth/secretkey/get 参数名称 | 描述 | 类型 | 备注 safetyMark | 安全标记(通过系统重置安全标记邮件获取) | string | 必填 获取方法:个人信息 - 重置我的安全标记 clientId | 注册时获得的客户端 ID | string | 必填 获取方法:管理设置 - 安全控制 - 已连接的应用程序 openSecretKey | 注册时获得的密钥 | string | 必填 获取方法:管理设置 - 安全控制 - 已连接的应用程序 orgId | 组织 ID | string | 必填 #### 私有云配置 "devConsoleConfig": { // CRM 开发者账户 "username": "admin@cloudccone.com", // 密钥(必须与 sysconfig-svc 配置文件中的 cloudcc.private.secretKey 匹配,私有云默认值:abc) "secretKey": "abc", // 私有云需要配置网关地址,注意:URL 不应以 / 结尾 "baseUrl": "http://xxx", // 私有云特有,固定格式用于标识私有云环境 "version": "private", // 安全标记(通过系统重置安全标记邮件获取) "safetyMark": "xxx", // 注册时获得的客户端 ID "clientId": "xxx", // 注册时获得的密钥 "openSecretKey": "xxx", // 组织 ID "orgId": "xxx" }, 参数名称 | 描述 | 类型 | 备注 safetyMark | 安全标记(通过系统重置安全标记邮件获取) | string | 必填 获取方法:个人信息 - 重置我的安全标记 clientId | 注册时获得的客户端 ID | string | 必填 获取方法:管理设置 - 安全控制 - 已连接的应用程序 openSecretKey | 注册时获得的密钥 | string | 必填 获取方法:管理设置 - 安全控制 - 已连接的应用程序 orgId | 组织 ID | string | 必填 baseUrl | 网关地址 | string | 登录 CloudCC CRM 系统,按 F12,在控制台输入:$CCDK.CCConfig.getBaseUrl() 获取私有云的 baseUrl #### 特殊配置 "devConsoleConfig": { // 服务访问地址: // 国内默认:https://developer.apis.cloudcc.cn // 海外默认:https://developer.apis.cloudcc.com "baseUrl": "http://xxx", // 组件后台销毁时间,设置为 10 分钟(10*60*1000) "destroyTimeout": 600000, // 开发者平台网关前缀名称,注意:URL 不应以 / 结尾 "devSvcDispatch": "/devconsole", // api-service 网关前缀地址,注意:URL 不应以 / 结尾 "apiSvcPrefix": "/xxx", // setup-svc 网关前缀地址,注意:URL 不应以 / 结尾 "setupSvcPrefix": "/xxx" }, ### 在 VS Code 中打开已创建的项目,右键点击项目文件,选择创建组件。 ### 将创建的组件导入到 App.vue 中 ### 刷新浏览器以预览 --------CloudCC 开发环境搭建指南结束-------- ` };