# AndroLua+ 布局编译器

**Repository Path**: AideLua/AndroLuaLayoutCompiler

## Basic Information

- **Project Name**: AndroLua+ 布局编译器
- **Description**: 将布局表转换为 Lua 代码
- **Primary Language**: Lua
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-07-27
- **Last Updated**: 2023-10-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: AndroLua, Lua, Android

## README

# AndroLua+布局编译器

**中文** | [English](README.md)

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

![Android 5.0+](https://img.shields.io/badge/Android-5.0%2B-green?logo=android)
![AndroLua+ 5.x](https://img.shields.io/badge/AndroLua%2B-5.x-blue?logo=lua&logoColor=blue)

## 示例

### 源文件

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

### 编译后

```lua
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](https://github.com/kikito/i18n.lua)
  - `lua/themeutil.lua` 自适应目标平台的主题助手。这是 AideLua 共享页面必备组件。
  - `main.lua` AndroLua+ 入口文件。
  - `init.lua` AndroLua+ 配置文件。
  - `layout.aly` 软件布局文件。
  - `helper.lua` 装有一些方法文件。
  - `layoutTemplate.lua` 布局模板。
  - `i18n/` 国际化配置文件。

## 安装教程

1. 进入 [Gitee 发行版](https://gitee.com/AideLua/AndroLuaLayoutCompiler/releases/latest)下载预编译的安装包，文件名通常以 `.apk` 结尾
2. 按照[《刷机指南 - 安装软件》](https://jesse205.github.io/FlashAndroidDevicesGuidelines/normal/installApk/)的教程安装本工具软件

## 使用说明

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

## 参与贡献

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

[Gitee](https://gitee.com/AideLua/AndroLuaLayoutCompiler) 仓库为主，[GitHub](https://github.com/AideLua/AndroLuaLayoutCompiler) 仓库为镜像。\
虽然在 GitHub 上的仓库为镜像，但也不妨碍您提交 Issue。

### 翻译

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

## 其他内容

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