README.zh.md

AndroLua+布局编译器

中文 | English

编译 AndroLua+ 布局，转换为 Lua 代码。

示例

源文件

{
  LinearLayout,
  orientation="vertical",
  layout_width="fill",
  layout_height="fill",
  {
    TextView,
    gravity="center",
    text="Hello AndroLua+",
    layout_width="fill",
    layout_height="fill",
  },
}

编译后

local LayoutHelper=require "LayoutHelper"
return function(root,group)
  local varsMap={}
  root=root or _G
  varsMap.view0=LinearLayout(activity)
  varsMap.params0=ViewGroup.LayoutParams(-1,-1)
  varsMap.params0=group and group.LayoutParams(varsMap.params0) or ViewGroup.LayoutParams(varsMap.params0)
  varsMap.view1=TextView(activity)
  varsMap.params1=LinearLayout.LayoutParams(ViewGroup.LayoutParams(-1,-1))
  varsMap.view1.setText("Hello AndroLua+")
  varsMap.view1.setGravity(17)
  varsMap.view1.setLayoutParams(varsMap.params1)
  --varsMap.params1=nil
  varsMap.view0.addView(varsMap.view1)
  --varsMap.view1=nil
  varsMap.view0.setOrientation(1)
  varsMap.view0.setLayoutParams(varsMap.params0)
  --varsMap.params0=nil
  --varsMap=nil
  return varsMap.view0
end

软件架构

• 核心文件
  • lua/compilelayout.lua 编译器本体。
  • lua/VituralG.lua 虚拟 _G，用于获取代码调用。
  • lua/obj2code.lua 将对象转换为代码的工具。
  • LayoutHelper.lua 布局助手，需要导入到目标软件内，以提供一些类。
• 其他文件
  • lua/i18n/ 供 lua 使用的 i18n.lua
  • lua/themeutil.lua 自适应目标平台的主题助手。这是 AideLua 共享页面必备组件。
  • main.lua AndroLua+ 入口文件。
  • init.lua AndroLua+ 配置文件。
  • layout.aly 软件布局文件。
  • helper.lua 装有一些方法文件。
  • layoutTemplate.lua 布局模板。
  • i18n/ 国际化配置文件。

安装教程

1. 进入 Gitee 发行版下载预编译的安装包，文件名通常以 .apk 结尾
2. 按照《刷机指南 - 安装软件》的教程安装本工具软件

使用说明

1. 填入信息到上面的编辑框内
2. 点击“导出 LayoutHelper”，将 LayoutHelper.lua 导出到 项目/lua 目录内（AideLua 为 项目/模块/类型/src/luaLibs）。
3. 点击“编译布局”按钮，选择保存路径。

参与贡献

1. Fork 本仓库
2. 新建 Feat_xxx 分支
3. 提交代码
4. 新建 Pull Request

Gitee 仓库为主，GitHub 仓库为镜像。
虽然在 GitHub 上的仓库为镜像，但也不妨碍您提交 Issue。

翻译

1. 复制 i18n/en.lua 到 i18n/你的语言.lua
2. 复制 i18n/en/* 到 i18n/你的语言/*
3. 翻译 i18n/你的语言.lua 和 i18n/你的语言/*
4. 提交代码并新建 Pull Request

其他内容

其他内容请见软件内使用说明。