OpenFace 模拟器使用说明
出自OpenFace
目录 |
１．引言
本文档用于描述如何使用OpenFace Player 模拟器运行（适用于OpenFace SDK 的2.0版本，点击查看1.1版本）。
开发一个mobile应用需要反复调试，但这种调试一般是先在模拟器上进行，然后再下载到手机上进行。模拟器的作用在于它能在PC上提供一种模拟手机运行环境，它减少了调试过程中反复下载应用到手机的时间消耗。
2．页面构成
模拟器页面包括3个区域，显示区域(左上)，信息窗口区域（右），键盘区域（左下）。 显示区域：用来显示程序运行结果。信息窗口区域：包含debug窗口和compile窗口，分别显示debug信息和编译结果信息。 键盘区域：包含手机模拟键盘和两个功能按钮，下载按钮和编译按钮。参见图1。
图1. 模拟器
“下载”按钮: 下载http服务器上的应用并运行。
“编译”按钮: 编译/运行本地应用。用本地tomcat服务器编译，首先需要启动tomcat服务器。
3．文件构成
模拟器包含OpenFace.exe和OpenFace.ini两个文件，使用模拟器时需要保证这两个文件位于同一个目录下。 在Mobile SDK 2.0 中， 这两个文件放置在%MobileSDK_HOME%\ emulator\Drivers\C目录中，OpenFace.exe是模拟器程序，运行它即可启动模拟器；OpenFace.ini是模拟器配置文件，用它来配置模拟器的屏幕大小和内存大小等。一般情况下，使用缺省配置即可。
注意：目前不支持含有中文的路径名。
4．文件配置/使用
（1）OpenFace.ini OpenFace.ini是模拟器的配置文件，可以用它来配置模拟器的编译文件，屏幕大小和内存大小等。一般情况下，使用缺省配置即可。编译文件设置参数compile-file用来设定编译运行的文件名。 例如：compile-file = HelloWorld/index.lzx 注意，这里的文件名是指在编译环境 OpenLaszlo/WebRoot目录下的。窗口大小设置 screen-width、screen-height这两个参数分别设置模拟器屏幕窗口，即“显示区域”的宽度和高度。 单位：px。内存大小设置 memory-size用于设置内存大小，十六进制，建议设置9M以上，内存使用的大小和应用及模拟器的显示屏幕大小相关。 单位：byte。
（2）OpenFace.exe 设置好OpenFace.ini后双击该OpenFace.exe即运行模拟器。程序启动后显示的是内置的desktop应用。 如果要运行其它应用，有两种方式：
a)、 本地编译： 在ini文件中设置好要编译的文件路径，然后点击“编译”按钮，待右边的输出窗口显示下载成功后即会自动运行刚刚编译好的应用。 这个路径是相对于WebRoot的路径。 例如需要编译OpenLaszlo/WebRoot/HelloWorld/index.lzx文件则在OpenFace.ini文件中加入 compile-file = HelloWorld/index.lzx
注：编译后形成的应用文件将会直接的生成到模拟器的root/eloo/download_apps 目录下，这里请留意。
b)、直接下载： 按“下载”按钮，弹出url输入框，输入完后按Enter即下载输入的应用。 比如http://www.eloomobile.com/stock.dat 对于你自己打包好并且在本机上的应用，可能是如 下格式： http://localhost:8080/OpenLaszlo/myapp/myapp.dat 其中，myapp是你应用的源文件目录名，myapp.dat是你应用编译时打包后的文件名。
（3）日志文件logfile.log 该文件在OpenFace.exe文件被执行后，自动生成在OpenFace.exe的同一目录下。记录了模拟器运行过程中的信息，应用中的调试信息也在该文件中。该文件在模拟器运行过程中动态更新，因此为了能观察到即时的输出信息请使用UltraEdit等工具进行查看而不要使用windows的记事本查看。1.1以上版本可以直接通过调试窗口查看log信息 。
5、模拟器的使用问题
如果新的模拟器在使用时，发现不能运行起来，请安装一个补丁程序，位于emulator_patch\vcredist_x86.exe，安装后就可以解决相应的问题。
