注意：由于作者本人已转行离开教育行业，平时工作时间也没有时间精力维护，除非放长假。因此此仓库处于半废弃状态，新功能更新会非常慢，并且不做保证。
Notice: This repo is semi-deprecated due to the author's new job. Updates are slow and not promised.
一个专门为树莓派设计的图形化编程平台，基于Google Blockly构建，适用于树莓派爱好者或者少儿编程学习。
A visual programming editor app for Raspberry Pi, built on Google Blockly, made for RPi users or kids to learn coding.
-
完整的Blockly移植到树莓派上，完全免费使用。Full Blockly features on RPi, free to use.
-
集成树莓派GPIO控制，支持Sense HAT和CSI摄像头，未来支持更多树莓派外设和功能。Build-in GPIO control, Sense HAT and CSI Picamera support, and more functions in the future.
-
程序可直接在应用内运行，同时可转化成Python代码，方便学习Python。Code runs in the app, and can be convert to Python. Helpful to learn Python.
-
支持繁简体中文、英语。Localization for English, Simplified/Traditional Chinese.
-
支持保存、载入程序。Support save&load codes.
安装好官方最新Raspberry Pi OS桌面系统（Raspberry Pi OS with desktop and recommended software）的树莓派（4B、3、3B、3B+等有40pin GPIO的型号）。
A Raspberry Pi with 40pin GPIO(4B, 3, 3B, 3B+...), with Raspberry Pi OS with desktop and recommended software installed.
如果不是，请确保树莓派系统中安装了Nodejs 12以上的版本和Python 3。
If not, please make sure your Linux-based RPi system have Nodejs v12+ and Python 3 installed.
在release页面下载最新版deb（推荐）或者AppImage安装包，保存到你的树莓派上。Download the latest release on the release page, choose deb(recommended) or AppImage, save it to your RPi.
-
双击deb文件直接安装。Double click the deb file to install.
-
或者使用用终端命令：Or you can use command in shell:
sudo dpkg -i blockpi_1.1.5_armv7l.deb注意自己的文件名。Pay attention to your file name.
如果安装失败，通常是系统内缺少必要模块导致的，输入
sudo apt install -f安装模块后重新输入安装命令。
！中国用户可能需要使用国内的Linux镜像源，请自行更改。
If failed to install. it's usually caused by the lack of some packages, try input
sudo apt install -fto install them and then try the dpkg command again.
先下载运行requirements.sh文件。First, download the requirements.sh file and run it.
右键AppImage文件，选择文件属性-权限-执行-所有人，确定。Right-click the AppImage file, choose file properties-permittions-execute-everyone, confirm.
双击直接运行程序。Double-click to run the APP.
如果不是官方最新系统，可能需要手动安装前置包：If your system is not the latest Raspbian, you may have to install some packages manually first:
sudo apt update
sudo apt install python3-gpiozero sense-hat python3-sense-emu sense-emu-tools python3-picamera下载安装包安装，在Windows上运行，可以正常编程，但是无法运行和树莓派硬件相关的程序。Download the installer and run it. You can program on Windows version but can't run any code related to RPi hardware.
-
UART、IIC、SPI设备支持，比如
数码管、LCD/OLED屏幕。UART, IIC, and SPI devices support, e.g.LED segments, LCD/OLED screen... -
更多Python功能和模块，比如
字典、爬虫、图片处理、Turtle等。More Python functions and modules likedictionary, http requests, pictures, and even Turtle. -
人工智能 AI
-
……
需要NodeJS 12以上稳定版，以及npm或者Yarn（推荐Yarn）。Need NodeJS v12 LTS+ and npm or Yarn(recommended).
克隆仓库/Clone repo：
git clone https://github.com/alienzhangyw/BlockPi.git安装/Install:
cd BlockPi
yarn install关于如何创建新积木，可以参考谷歌Blockly的文档。View Google Blockly’s docs can help you create new blocks.
打包所有积木脚本/Build all blocks:
yarn build:blocks打包Python代码生成脚本/Build Python code generator:
yarn build:generator运行BlockPi/Run BlockPi:
yarn start打包发行Windows版本/Pack and build Windows version:
yarn dist:win打包发行树莓派版本/Pack and build RPi versions:
yarn dist:linux树莓派版本只能在非arm架构的Linux系统（如Ubuntu或WSL）打包，遇到权限问题需要在命令前加上sudo。RPi versions only can be build on none-arm Linux system such as Ubuntu or WSL. You may need 'sudo' if meet permission issues.
-
Q：软件收费吗？Is this app free？
A：不，完全免费。Yes, it's totally free!
-
Q：和树莓派上自带的Scratch3有什么区别？What's the difference between BlockPi and Scratch3 on Raspbian?
A：BlockPi能够生成Python代码，未来会更新更多Scratch3上没有的功能，更多传感器设备支持和人工智能功能。BlockPi can generate Python code. In the future, I will update more features than Scratch3, more sensor device support and even AI functions.
-
Q：有使用说明或者教程吗？Any tutorials?
A：在项目Wiki页面有持续更新一些教程和案例，也可以关注我的知乎专栏BlockPi树莓派图形化编程。I keep updating some tutorials on the Wiki page.