![[二开笔记] 如何使用协同开发平台进行新项目开发](https://media.my7c.com:19000/files/202409/16/a1c499ad-d026-44a8-a462-6bb7e53d4877.jpg)
## 前言
金蝶云社区 2022-02-28 发布了一个公告 —— [BOS设计器登录统一升级通过协同开发云进入BOS开发平台,原有登录方式兼容[需进行延用申请]](https://wenku.my7c.com/article/278828081815529984),这意味着后期将全面使用协同开发云进行开发,当前公司内部系统开发人员需要尽快熟悉协同开发云的开发模式。实操处理了一段时间后,记录下当前亲测有效的新项目开发流程,不管这个流程有多么的荒谬。。。
## 开发环境
| 信息 | 说明 |
| ---------------- | ---------------------------------------------------- |
| 操作系统版本 | Microsoft Windows 10 专业工作站版 10.0.19042 64 位 |
| 金蝶云星空版本 | v7.7.0.202112 |
| BOS 版本 | v7.72388.8 |
## 操作步骤
### Step 1 重启 IIS
使用 `管理员权限` 启动 `cmd` 执行
```powershell
iisreset
```
### Step 2 登录协同开发平台

需要注意的是,这里的账号不是系统账号,而是金蝶云账号,如果没有账号则需要注册,然后再绑定系统账号。具体操作参考:[BOS设计器登录统一升级通过协同开发云进入BOS开发平台,原有登录方式兼容[需进行延用申请]](https://wenku.my7c.com/article/278828081815529984)
### Step 3 创建应用


`应用名称` 和 `应用简介` 这两个字段一定要填,不填就会出问题,暂时不知道为什么。
输入 `应用名称` 和 `应用简介`后,下方`基本信息`页签下的`方案文件`和`本地工作区` 都会同步修改。这里需要注意的是:`本地工作区`的路径内 **不可以包括中文字符**,否则后期搭建开发环境可能会不成功 (Yogurt 实测本机不成功,也不知道为嘛)。填写万信息后直接点击`修改提交` 即可。

上图为 `应用名称` 为中文或 `应用简介` 未填写时的报错。填完信息后,等待执行。

等待执行完毕,将在 `我的应用` 对话框中看到新建的项目

点击 `开发` 按钮进入项目,然后选择一个 `子系统`

等待初始化完毕后,将看到以下内容

### Step 4 搭建开发环境
这是一个最容易出问题的地方。。。你可能需要在这里折腾很久,以下是实测出问题的处理方案。
鼠标右键点击 `项目名称`,在弹出的菜单中选择 `搭建开发环境`,这个操作在初始化、重新安装、变更开发环境版本时都需要用到。

选择安装的 `版本号` 和 `补丁包`。

不管卡死多少次,只要没有出现下面的窗口,都不算搭建完成。其他的情况如果卡死了,什么的,不用管其他的,直接关掉,用 `管理员权限` 使用 `cmd` 重启 IIS。然后进入先登录 `协同开发平台`, 按 Step 4 的步骤重新搭建开发环境,直到看到这个完成界面。

此时,关掉安装完成界面后,所有的操作都是不能用的 (个人估计是系统自动切换了服务器地址)。此时需要关掉开发平台,**然后按 Step 1 的步骤,重启 IIS**。
### Step 5 配置开发环境
重新进入协同开发平台后,找到项目并点击 `开发` 按钮进入项目。在右侧项目栏中,鼠标右键点击 `项目名称`,在弹出的菜单中选择 `启动开发环境`。**这步必须做,不做就会启动不成功!!!**

理论上应该是可以启动成功的,但是 Yogurt 从来没有启动成功过。全都是下图:

不过不用管它,失败就是失败了。关掉这些窗口后,在右侧项目栏中,鼠标右键点击 `项目名称`,在弹出的菜单中选择 `配置开发环境`。需要修改 `端口号` 和 `生成启动开发环境的BAT命令`。

输入 `端口号`,一般是 `1200` 。
> 如果端口默认不是 `1200` ,而是显示 `0` 的话,请不要做任何操作,关闭窗口,在右侧项目栏中,鼠标右键点击 `项目名称`,在弹出的菜单中选择 `启动开发环境`。关闭相关窗口后重复本次操作。
然后点击 `生成启动开发环境的BAT命令` 按钮。

> 上图笔误,`多次创建就变成 0` 应为 `创建失败就变成 0`
Yogurt 的习惯是将该文件保存至项目目录内与 `K3Cloud` 文件夹同一目录下,比较好找

做完这些操作之后,就正常关闭协同开发平台。重启 IIS。
### Step 6 启动开发环境
打开项目目录,找到步骤 Step 5 创建的 `StartService.bat` 文件,就是那个用来 `启动开发环境的BAT命令`。鼠标选中后右键选择 `以管理员身份运行`

将会打开两个窗口,一个是 IISExpress.exe,一个是浏览器。实测需要等待约 3-5 分钟左右才会启动完成,这时你可以喝口水,放松一下。

如果看到这个页面,恭喜你,开发环境顺利搭建完成了。

否则需要从 Step 1 再来一次,例如你看到了下面这个图的话。

### Step 7 登录开发环境
Step 6 正常启动成功后,打开 `协同开发平台` 在登录界面的 `服务器设置` 中输入 `http://localhost:配置的端口`,例如这里配置的端口为 `1203`,因此输入的是 `http://localhost:1203`。

修改完后,正常登录即可。
至此开发环境全部搭建完成。后续正常创建各种插件工程和表单即可。
## 后记
虽然 Yogurt 惊叹于金蝶云星空的动态领域模型和对数据库的优化,但这确实是接触开发工作以来配置过最麻烦也是最无语的开发环境,希望这只会在 Yogurt 的电脑上出现这样的问题。
这个操作已经 "难为" Yogurt 两天一夜了,终于找到了正确配置的方法,但还是希望官方能优化一下这个搭建步骤,实在是太麻烦了。整整两天一夜,不断的找资料和测试,光是文中的这个步骤就已经不下 40 遍了。当前测试通过的步骤也经过了 2 次的复查测试,都是顺利通过的,如果有同样困扰的小伙伴可以参考一下。
经过今天客服小姐姐的处理 启动开发环境的报错已经解决了 原因是默认浏览器的问题 我的默认浏览器是 Chrome 启动开发环境的时候会自动启动一个浏览器 需要 IE 浏览器才行 把客服小姐姐默认浏览器改成 IE 之后 这个就不报错了
但是呢。。。先不说 IE 浏览器启动的这个有多鸡肋了。。。毕竟管理中心提示要使用谷歌浏览器 这个先放一边。。。有个更神奇的事情是。。。在启动完开发环境之后 还是需要我退出登录 然后用启动完成后的服务器地址来登录 才能使用开发环境。。。这就有点无语了。。。
在我的理解里 应该是开发环境启动后 协同开发平台应该是自己就会帮我把服务器地址改成开发环境的服务地址才对 而不需要我退出再修改服务器地址。。。不知道是我哪里没设置对
你好,能否留一下联系方式,希望与你这边进一步交流,改善开发体验,不好意思,给你带来的开发的不便
