就本人实际测试智行者IC社区SDK的2.3.1版本而言，曾遭遇过因工具链路径配置错误从而致使编译结果全为红色的情况，对于新手来讲，只要依照下面的三个步骤依次进行操作，便……
就本人实际测试智行者IC社区SDK的2.3.1版本而言，曾遭遇过因工具链路径配置错误从而致使编译结果全为红色的情况，对于新手来讲，只要依照下面的三个步骤依次进行操作，便能够轻松地避开此类较为常见的问题。
1 账号注册与权限申请
开启智行者IC社区的官网，在右上角那儿点击“注册”，运用公司邮箱或者学校edu的邮箱搞完注册。登录之后进入那个“开发者中心”，寻觅到“SDK下载权限申请”的按钮，填好项目名称以及用途，提交之后正常来讲2小时以内会收到审核通过的邮件。
【新手避坑】
平常出现的报错情形是，提交之后始终呈现“审核中”的状态。其关键缘由在于，邮箱的域名并非处于白名单范围之内，像个人邮箱（举例来说163、qq这些）时常会遭遇卡顿状况。径直换用公司或者学校邮箱的方式，再次执行注册的操作，并且将工牌亦或是学生证的照片，附加于申请理由之中，速度最快的情况下，半个小时便可以通过审核。
2 SDK资源下载与MD5校验
完成审核通过这个步骤之后，进行登录社区的操作，接着进入到“资源中心”里面，从中选择“IC系列SDK”这一项，然后在版本号所在处通过下拉的方式去选取“v2.3.1”，最后点击“下载完整工具链”这个按钮。将其进行下载，之后把终端予以打开，接着去执行md5相关指令，即md5sum并且紧跟zx_sdk_v2.3.1.tar.gz，以此来核对官网所给出的对应md5值，也就是a7f3c8e9d2b1，一旦两者不一致，那么就要重新开展下载操作。
【新手避坑】
常常遭遇到的状况是，下载进行到一半的时候就会断开连接，解压的时候会弹出“文件损坏”的提示。MD5校验这件事是必须要去做的，在官网的每个版本右侧都粘贴上传了md5的值。进行下载请使用wget -c命令来实现断点续传，千万不要使用浏览器直接去下载，因为一旦出现网络波动必然会损坏包。
3 环境变量配置与编译验证
将其解压至 /opt/zx_sdk_v2.3.1 这个路径，对~/.bashrc 进行编辑，于其末尾增添如下内容。
export ZX_TOOLCHAIN=/opt/zx_sdk_v2.3.1/toolchain
export PATH=$ZX_TOOLCHAIN/bin:$PATH
于保存之后，去执行source~/.bashrc ，而后进入示例工程目录，此目录为/opt/zx_sdk_v2.3.1/examples/led_blink ，接着执行make clean && make ，当看到生成led_blink.bin时，便意味着配置成功。
值得重点关注的参数之中，具备最佳推荐价值的那个值是，将交叉编译链的路径设定为 /opt/zx/arm-none-eabi-10.2.1 ，而非原本默认状态下的 /usr/local。之所以这样，是因为社区SDK 2.3.1有着强制要求，它要求的是10.2.1版本的gcc，把它安装在系统默认路径的话，很容易就会被系统更新给覆盖掉，而独立放置在/opt/zx之下，能够起到隔离版本冲突的作用。
两种实操方案对比
在Ubuntu 20.04系统上面直接进行本地编译来配置环境，这种方式适宜于单次调试，其所占用的空间相对较小（大概为2GB），然而存在的缺点是一旦更换电脑就必须重新进行配置啦。
在Docker容器编译时， 需要去拉取社区官方镜像，也就是执行docker pull zx_ic/sdk_builder:2.3.1这个操作 ，之后在启动容器以后要挂载代码目录，这种方式适合团队统一环境以及CI/CD流水线。
对于取舍逻辑而言，就个人学习这一方面来讲，采用的是本地编译方式，而在项目开发的情况下，必定是要使用Docker的，否则的话，与同事传过来的工程，你是无法使其运行起来的。
高频报错完整解决流程
出现错误提示发出信号，即arm-none-eabi-gcc，该指令未被找到。
1. 先对which arm-none-eabi-gcc进行检查，若没有输出，那就表明路径添加得不对。
2. 要看一下 echo $PATH 之中，是不是有 /opt/zx_sdk_v2.3.1/toolchain/bin 这个路径。
3. 要是不存在，那就查看~/.bashrc里的路径有没有写错，像是有没有遗漏/bin这种情况。
4. 重新source ~/.bashrc，还不行就重启终端。
5. 极个别的情形属于权限方面的毛病，去施行chmod -R 755 /opt/zx_sdk_v2.3.1/ toolchain。
此方法不适用于针对于借助CMD方式或者PowerShell方式直接编译的Windows原生环境情形，社区SDK 2.3.1版本的makefile是依赖bash环境作用的。存在替代方案：安装WSL2 Ubuntu 20.04版本，在WSL当中完整地依照上面所提及的三步进行操作，经过实际测试能够完美运行。你在进行环境配置的时候是在哪一个报错环节上出现了卡顿情况呢？在评论区张贴出来，我来帮你进行定位。
微信扫一扫 
