【亲测免费】 LocalizableTool 使用教程

LocalizableTool 使用教程

1. 项目的目录结构及介绍

LocalizableTool 是一个用于 Android 开发国际化的可视化工具，支持将 strings.xml 与 Excel 文件互相转换。以下是项目的目录结构及各文件的简要介绍：

LocalizableTool/
├── idea/
├── python/
├── screenshot/
├── .gitignore
├── LICENSE
├── LocalizableTool.iml
├── README.md
├── setup.py
└── LocalizableTool.py

• idea/: 存放项目相关的 IDE 配置文件。
• python/: 存放 Python 脚本文件。
• screenshot/: 存放项目截图文件。
• .gitignore: Git 忽略文件配置。
• LICENSE: 项目许可证文件，采用 MIT 许可证。
• LocalizableTool.iml: IntelliJ IDEA 项目文件。
• README.md: 项目说明文档。
• setup.py: Python 项目安装脚本。
• LocalizableTool.py: 项目的主启动文件。

2. 项目的启动文件介绍

项目的启动文件是 LocalizableTool.py。该文件包含了项目的核心逻辑，用于启动可视化界面并执行 strings.xml 与 Excel 文件的转换操作。

# LocalizableTool.py

import sys
from PyQt5.QtWidgets import QApplication
from LocalizableTool import MainWindow

if __name__ == "__main__":
    app = QApplication(sys.argv)
    mainWindow = MainWindow()
    mainWindow.show()
    sys.exit(app.exec_())

• 导入模块: 导入了 sys 和 PyQt5.QtWidgets 模块，用于创建应用程序和主窗口。
• 创建应用实例: 使用 QApplication 创建应用程序实例。
• 创建主窗口: 创建 MainWindow 实例，并显示主窗口。
• 运行应用: 使用 sys.exit(app.exec_()) 运行应用程序，确保程序在关闭时正确退出。

3. 项目的配置文件介绍

项目中没有明确的配置文件，但可以通过修改 LocalizableTool.py 中的代码来调整工具的行为。例如，可以修改以下部分来调整文件转换的默认路径或模式：

# LocalizableTool.py

class MainWindow(QMainWindow):
    def __init__(self):
        super(MainWindow, self).__init__()
        self.initUI()

    def initUI(self):
        # 设置默认路径和模式
        self.source_folder = "path/to/source"
        self.target_folder = "path/to/target"
        self.mode = "Single"  # 或 "Multiple"

        # 其他 UI 初始化代码
        ...

• source_folder: 设置默认的源文件夹路径。
• target_folder: 设置默认的目标文件夹路径。
• mode: 设置默认的转换模式，可以是 Single 或 Multiple。

通过修改这些变量，可以自定义工具的默认行为，以适应不同的使用场景。