pyera开发环境配置

pyera引擎的开发环境非常灵活，可以根据不同的功能需求等级进行选择。分为两种配置，和两个进阶功能：

1. 简易配置环境 (pyera Debug版本程序 & notepad++)
   适合简单的功能开发，拥有简单的Debug功能
2. 完全配置环境 (pyera源码 & python 3.6 & pycharm )
   适合复杂开发，拥有完整的Debug功能

进阶功能一：从源码构建windows exe执行程序：

• 配置环境 (pyera源码 & python 3.6 & pycharm & cx_freeze )
  适合需要对pyera引擎进行修改或扩展复杂的第三方模块的开发

进阶功能二：基于pyera引擎网页版的开发

• 配置环境 (pyera源码 & python 3.6 & pycharm & flask & flask-socketio)
  适合想尝试pyera网页版的开发人员

注意：

1. python版本为3.6
2. python自带的基础模块一般不用另行添加，直接引用即可。如果发现引用的模块没有的情况，可能需要进阶功能一重新打包。

简易配置环境

配置：pyera程序 & notepad++

适用：开发一些简单的功能。因为这种条件下可以进行一定程度的debug，所以可以用来开发。同时不需要复杂的配置，因此也是初学者开发简单的游戏dome。

说明：运行pyeraDebug.bat可以启动debug模式。pyera_debug版本的程序与普通模式的程序的区别是提供了一个控制台输出窗口。这样一旦发生bug，bug的错误信息会完整的显示在控制台中。开发者可以利用print函数输出内容到控制台，以获得额外的输出信息。Notepad++则提供代码高亮等功能，可以更加方便快捷的进行开发。当然只是简单修改的话，记事本也是完全可以的。

发行：可以不进行额外的步骤进行发行。将制作/修改好的游戏直接分享给他人即可。

完全配置环境

配置：pyera源码 & python 3.6 & pycharm

适用：适合复杂功能的开发项目，比如做一款原创的基于pyera的游戏。或者大幅度的更改某一个基于pyera的游戏。

说明：pycharm 可以提供完整的集成开发环境，包括丰富的debug功能，比如单步调试，变量查看等等。不过配置过程略微复杂。是时候考验你对游戏的热情了！

发行：将对应的script和data文件夹拷贝到对应版本的构建好pyera引擎中就可以顺利运行了。如果不能确定的时候是否有版本一致的pyera，可以直接构建游戏得到一个运行包，就可以运行了。具体构建方法参考进阶功能一：构建windows exe执行程序。

1. 安装Python+pycharm：参考 http://guoxh.blog.51cto.com/10976315/1927909
   注意:pycharm 选择community版本即可。
   汉化说明：可以的话，非常推荐使用英文版的pycharm，不容易出问题。
   不过真的需要汉化包的话可以下载此款： http://www.itmop.com/downinfo/130758.html 下载时注意从“其他下载地址”处下载

2. pyera源码获取：https://github.com/qsjl11/pyera 右侧绿色按钮 dowload zip即可
   

   

   image.png

3. 加载代码：用pycharm菜单file->open->选择解压缩的文件夹->open in current window 即可加载

4. 左侧project窗口中右键点击pyera_engine的文件夹选择 pyera_engine 文件夹->mark directory as ->sources root

   
   
   

   image.png

5. 右键点击pyera_engine/pyera.py -> run pyera, 可以运行弹出游戏窗口证明配置完毕

   
   
   

   image.png

6. 可以开始制作自己的游戏啦。

进阶功能一

从源码构建windows exe执行程序：
需要加载cx_freeze 模块才能够完成打包。不过程序已经考虑这一点了。通常来说，在联网状态下（目的是可以自动下载cx_freeze的安装），运行目录下的build.py即可。会生成一个pyera_dist 文件夹和对应zip压缩文件。Pyera_dist 文件夹就是可以发布的版本了。
建议发布前在其他未安装的电脑python的电脑上测试一下运行能否成功。

进阶功能二

目前pyera的网页引擎尽管可以运行但尚不够完善，因此配置过程很难写成简单的文档。如果您想尝试这个功能，本文档假定您有一定python配置经验和网络配置经验。

1. python需要安装flask和flask-socketio两个模块，可能需要手动添加eventlet模块。
2. 如果您要发布到服务器上去可能需要配置反向代理等，这里不做过多的介绍。相关的配置请参考flask/flask-socketio配置的说明。配置内容主要集中于pyera_engine/core/webframe的前65行中。
3. pyera采用的websocket协议进行通讯，请配置时候注意。