3.1. 十分钟部署到新平台

3.1. 十分钟部署到新平台

3.1.1. 如何选择可以运行 pikascript 的平台

PikaScript 可以在所有 支持 libc 的裸机和操作系统上运行。
编译器需要能够支持 C99 标准。
支持 32位/64位 内核，不支持 8 位内核。
资源占用
- 如果是 arm 内核，考虑到拓展模块的资源占用，最低应该配备 64k flash 和 8k ram。
- 如果是 risc-v 内核，则需要 128k flash和 8k ram ，因为 risc-v 内核的 gcc 优化以及代码密度等问题，代码体积比 arm 内核大很多。
- 如果是 其他内核，可以参考 risc-v 的配置需求。
如果是 PC /服务器平台，则 linux/windows 均可。

在本篇文档中，将会介绍为新平台部署 PikaScript 的方法。PikaScript 几乎没有全局变量和宏，仅依赖标准库，因此为新平台部署 PikaScript 是非常容易的。

下面是部署 PikaScript 的具体步骤

3.1.2. 准备模板工程

你的模板工程仅需要包含一个支持 printf 的串口初始化，然后就可以愉快地使用 pikascript 了。通常的脚本解释器都依赖操作系统和文件系统，而 pikascript 不需要这些，如果你部署过其他的脚本引擎，就会发现 PikaScrip 具有真正的超轻量级特性。

3.1.3. 获取 PikaScript 源码和工具集

获取 PikaScsript 可以使用 pika 包管理器(方案1)，或者使用官网的工程生成器(方案2)。

方案2是方案1的自动化版本，推荐新手第一次部署时使用方案1，以熟悉包管理器。

3.1.3.1. 方案1 使用 pika 包管理器

3.1.3.1.1. 下载 PikaScript 包管理器

PikaScript 包管理器可以帮助你拉取 pikascript 所需要的所有源码和工具，并且提供版本选择功能，方便你切换版本。并且 PikaScript 包管理器使用 gitee 源，能够在大陆顺畅地使用，不需要科学上网。

进入 PikaScript 主仓库

https://github.com/mimilib/pikascript

或者：

https://gitee.com/lyon1998/pikascript

下载 PikaScript 包管理器 PikaPackage.exe

然后打开你要部署的工程，在工程的根目录下新建 pikascript 文件夹，然后把 PikaPackage.exe 复制进去。

3.1.3.1.2. 安装模块

接下来，在 PikaPackage.exe 的帮助下我们可以轻松地拉取指定版本的源码和模块。拉取源码和模块通过一个requestment.txt 的文件，如果你熟悉 python 的 pip 包管理器，就会发现，pikascript 的 requestment.txt 文件格式与 pip 是一致的。

在项目的 pikascript 文件夹下新建一个 requestment.txt 文件，然后写入以下内容。

pikascript-core==v1.11.0
PikaStdLib==v1.11.0

requestment.txt 文件中表示表示使用 v1.10.0 版本的 pikascript 解释器内核和 v1.10.0 版本的标准库，解释器内核和标准库是必选项，这两个的版本号保持一致即可，而其他的模块可以有选择地添加，在初次部署时，应当只添加内核和标准库以避免遇到兼容性问题。

目前只支持 == 符号，表示严格匹配版本号。

还有一个特殊的版本是 latest，表示拉取最新的模块，这个最新指的是 pikascript 仓库中 master 分支的最新版本。如果你是模块的使用者而非开发者，请注意不要使用 latest 版本。因为 latest 版本在不断变动，新版本的模块可能导致兼容性问题。

你可以照抄 stm32g070 的 requestment.txt 内核和标准库版本, 这是官方支持的开发板 Pika派—Zero 所使用的版本。而所有可选的版本可以在 packages.toml 文件中查看。

现在的 pikascript 文件夹就有了 pikaPackage.exe 和 requestment.txt 两个文件，双击运行 pikaPackage.exe，在 requestmemt.txt 中指定的源码和模块就会被拉取下来。

拉取后的文件如下图所示，pikascript-core 是内核源码，pikascript-lib 是模块库，pikascript-api 是模块 API ， rust-msc-latest-win10.exe 是 pikascript 专用的预编译器。

如果你想升级版本，在 requestment.txt 中修改版本号然后再次运行 pikaPackage.exe 即可，原先的版本会被覆盖。

3.1.3.1.3. 编写 main.py

拉取完源码之后，接下来编写 pikascript 运行的 python 脚本，我们在 pikascript 文件夹新建一个 main.py 文件。

然后写入:

import PikaStdLib
print('hello PikaScript!')

其中import PikaStdLib 表示导入标准库，标准库是必须要导入的，即使没有直接用到，而print('hello PikaScript!')用于测试pikascript是否正常启动。

3.1.3.2. 方案2 使用官网的工程生成器

进入官网：http://pikascript.com/

平台选择 template, 然后点击 “开始生成” 即可获取默认的 reqeustment.txt，main.py，和 pikaPackages.exe，在生成工程的同时，源码和工具就已经自动打包好了。

3.1.4. 预编译模块

接下来运行 rust-msc-latest-win10.exe，将 main.py 和导入的模块预编译为 pikascript 的 api 文件，预编译后的文件在 pikascript-api 文件夹内。我们打开 pikascript-api 文件夹，发现里面有一些 .c 和 .h 文件，就说明预编译是成功的，pikascript 预编译器可以把 python 模块预编译为 .c 和 .h 文件。