第一课：YXRA-SDK运行环境及安装

leoringyang

YXRA-SDK集成开发工具运行在Java的环境下。Java是一种跨操作系统的开发语言，YXRA-SDK集成开发工具正是看在这一点上而选择Java作为过渡阶段的开发语言。下面列出了一些市场上份额较大的操作系统支持的情况。注意：java为开发语言名称，java运行环境为jre，开发环境为jdk。一般开发环境会包括运行环境，即安装jdk时会要求安装jre，这两者会一同安装。我们常说的安装java或jdk版本均是指开发环境+运行环境。
    32位windows2000、windowsxp可正常运行，需要安装与之匹配的32位jdk16+；
    64位windows7、windows8、windows10、windows11等可正常运行，需要安装与之匹配的64位jdk18+；
    桌面版Linux（Ubuntu、Fedora、银河麒麟、统信UOS等）可正常运行，需要安装与之匹配的jdk16+；
    MacOS可正常运行，需要安装与之匹配的jdk18+，推荐jdk11版本；
    其他操作系统，如果能正常支持jdk16+，基本上可正常运行YXRA-SDK集成开发工具；

一、java如何安装？
    不同操作系统安装方法不一样。下面以windows为例。首先下载与操作系统匹配的jdk版本，一般是jdk18。虽然现在java版本已到2x甚到更高，对于YXRA-SDK开发工具而言，能正常运行即可，无须追求更高版本。到oracle官网上下载对于新手会有很多困难，纯英文可以调用浏览器上的自动翻译功能，主要是下载的网速慢，毕竟不在本土。可以考虑从镜像网站或是云盘等地方去下载。java现在依然是业务开发霸主的开发语言，获取开发环境应该不难。
    顺利下载完jdk后就是安装。windows下jdk18的大小大约是100M上下，其他版本会不一样。双击或以管理员运行，会弹出安装窗体。如果要求指定安装位置，对于新手一定要注意，java有时对空格或中文这些字符的支持力度是不够的，请将jdk安装到c:/jdk/下，至于jre环境的安装目录没有什么要求，因为jdk环境中已经存在jre。
    为什么在开发文档中建议jdk安装在c:/jdk/下？主要原因除java中文支持力度外，启动脚本中startup.bat指定的java目录就在这个目录下（也有可能为c:/jdk16/......）。
    安装完成后，我们来验证jdk安装是否成功。一般来说无须作任何配置，即可以在command窗体中输入java -version查看安装结果。如果提示没有找到命令，解决方法之一是需要配置java的path，在系统变量path中添加jdk的安装路径，这样可以让windows顺着这些路径找到java.exe并执行。解决方法之二是通过cd命令进入到jdk安装目录中，如果你是安装在c:/jdk/下，那么你需要进入c:/jdk/bin/这个目录，java.exe在这个目录下，同样设置path也是这个目录。如果可以看到java的版本，恭喜你成功安装了jdk了，可以进行下一步。

二、YXRA-SDK如何安装？
    YXRA-SDK安装包为一个绿色压缩文件，直接解压到指定目录下，解压完成后可以看到如下目录结构：
    classes目录：系统运行类以及资源
    startup.bat：windows下启动YXRA-SDK集成开发工具的脚本
    yxrastart.jar：Java启动YXRA-SDK程序
    *proplate.cfg：项目文件，初始安装不存在，需要创建项目才生成
    *yxraconfig.txt：系统关键配置信息，初始安装不存，需要运行后才生成
    jdk安装与YXRA-SDK没有先后关系，但必须正确安装jdk后才可以通过startup.bat运行YXRA-SDK。
    不同操作系统启动程序的方式可查看java程序运行。

三、如何运行YXRA-SDK开发工具？
    在打开YXRA-SDK开发工具之前，一定要确认jdk已成功安装，且版本不得低于jdk16，因为开发者是在jdk16上开发的，运行的jdk版本一定要大于等于这个版本。注意，jdk16+这个并不是一个具体的版本，而是指版本号大于等于jdk16。jdk已成功安装，下载YXRA-SDK开发工具压缩包，官方一般取名为yxrastart.zip，如果不包绿色版jdk（有时为了方便新手顺利安装，会将jdk的绿色版本一同压缩到文件中，这样只需要解压即完成了jdk安装和YXRA-SDK的解压），其大小一般在5M左右。开发工具压缩包建议解压到根目录，比如在c:，解压后的程序目录为c:/yxrastart/，方便查找也不会有空格等字符。打开解压所在的目录，双击或右击打开startup.bat，程序会首先打开command窗体，这是java.exe运行程序默认方式，是日志输出窗体。如果顺利，接着你就能看到YXRA-SDK开发工具的真面目了。

leoringyang

YXRA-SDK是基于Yxra开发语言的纯国产软件。此工具为开发单片机以及操作系统提供了新的方案。yxra开发语言面向硬件，面向对象，用YXRA-SDK开发STC32、STM32、ESP32这些单片机，比keil要更快捷，它将繁杂的硬件初始化以可视化方式来配置，增加了GPIO复用冲突检测，以及配置冲突检测，让开发者减少开发中的问题。