PlatformIO离线安装终极方法

PlatformIO IDE (core)离线安装终极方法

​ 众所周知，PlatformIO的资源服务器在国外，其资源包和更新包经常出现下载不了而导致PlatformIO Home界面无法启动的情况。

​ 这几年，我上的智能硬件课程中使用PlatformIO作为课程的开发环境。在机房软件环境配置中，我是从一台通宵开几天，成功在线安装后的电脑中拷贝出内核和环境文件去配置其它电脑。由于机房中机器环境都是相同的，所以配置起来没什么问题。但是这次网课期间，在学生自己电脑上配置，仍然安装上述方法，有许多学生电脑仍然出现PlatformIO-IDE页面无法显示问题。后来查其原因，是因为学生的电脑用户名千奇百怪造成的。

​ 这次为了彻底解决PlatformIO环境安装问题，经过研究得出了以下方法。

---

​ 其实，PlatformIO 由IDE 和 Core(CLI)两部分组成，Core是组成PlatformIO的核心部分，具有编译等脚本程序。在通过Vscode扩展安装PlatformIO - IDE的时候，会自动安装一个builtin版本的Core在penv文件夹下。IDE有无法检测到Core安装成功，所以导致一直无法打开软件。本次我采用Core和IDE分开安装的方法。

1.安装python环境

python 需要安装 3.6+以上版本。

可使用CMD界面下使用以下命令查看当前电脑python版本
python --version 如果不满足要求，请重新下载安装。 python 3.9.2下载

2. PIP安装Platform Core

通过以下pip命令安装platform Core

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple platformio

注意：-i https://pypi.tuna.tsinghua.edu.cn/simple 为切换为清华的pip镜像，否则安装包很难下载

安装完毕后，显示Warning：

WARNING: The scripts pyserial-miniterm.exe and pyserial-ports.exe are installed in 'C:\Users\newuser1\AppData\Roaming\Python\Python39\Scripts' which is not on PATH.

根据以上提示，将路径C:\Users\newuser1\AppData\Roaming\Python\Python39\Scripts添加到用户或全局path中。

重新打开CMD窗口，输入以下命令：

pio --version

正常输出以上版本信息，说明PIO-Core安装完毕。

3. 解压PlarformIO_Core并设置环境变量

​ 将这里提供了PlatformIO离线平台和工具包解压到自定义文件夹下，最好路径不要包含中文符号。PlatformIO离线资源包

这个本地资源包里提供了 ststm32 和 atmelavr 两个平台，Packages中提供了 arduino \ cmsis \ stm32cube 三种框架。

通过 pio system info指令查看pio系统信息：

其中，PlatformIo Core Directory默认在C盘用户目录下，通过PIO环境设置https://docs.platformio.org/en/latest/envvars.html#directories 学习，了解到通过设置环境变量PLATFORMIO_CORE_DIR的值来修改路径。

重新打开CMD窗口，输入指令:pio system info查看pio系统信息。可见PIO已经可识别 core directory路径和检测出2个可用开发平台和17个工具和工具链。

到此为止，其实PIO-Core环境+资源包已经安装完毕，如果会使用命令行指令的话，可用使用pio project init指令创建项目。CLI命令行指令使用方法在后期更新博客讲解。

4.安装Vscode和platformIO IDE扩展

VScode的安装忽略了，可直接在网上下载或搜索安装方面

这边演示离线包安装方法：

1. 通过https://marketplace.visualstudio.com/items?itemName=platformio.platformio-ide Vscode扩展市场下载 platformIO IDE 的vsix安装包。 下载 platformio vsix

2. 打开vscode，按下图选择 从VSIX安装... 安装上面下载的离线vsix文件。
   

3. 设置PlatformIO IDE使用非内置core
   
   在搜索栏内输入platformio,右侧向下滚动找到在settings.json中编辑，点击打开json配置文件。
   
   在配置文件内添加以下三条配置信息：

     "platformio-ide.useBuiltinPIOCore": false,
     "platformio-ide.useBuiltinPython": false,
     "platformio-ide.customPATH": "your python dir\\Script"
   

   注意：：其中，customPATH为前面配置到path中的路径，根据实际安装位置确定。

4. 重新启动Vscode,即可打开platformIO ide