コード例 #1
0
class LeeMenu:
    def __init__(self):
        self.patchManager = LeePatchManager()
        self.buttonTranslator = LeeButtonTranslator()
        self.leeVerifier = LeeVerifier()
        self.leeCommon = LeeCommon()

    def menufuncResetWorkshop(self):
        '''
        重置 LeeClient 客户端环境
        为接下来切换其他版本的客户端做好准备
        '''
        try:
            print('正在重置按钮汉化文件 ...')
            self.buttonTranslator.doRevert('AllVersions')

            print('正在重置其他客户端资源 ...')
            self.patchManager.doRevertPatch()

            leeClientDir = self.leeCommon.client(withmark=False)
            if self.leeCommon.isFileExists('%s/data.grf' % leeClientDir):
                os.remove('%s/data.grf' % leeClientDir)

            # 移除各个 Patches 版本目录中的 Temporary 目录
            clientList = self.leeCommon.getRagexeClientList(
                self.leeCommon.patches())
            for x in clientList:
                temporaryDir = self.leeCommon.special(x, 'temporary')
                self.leeCommon.removeDirectory(temporaryDir)

            print('正在删除空目录 ...')
            self.leeCommon.removeEmptyDirectorys(leeClientDir)

            print('已成功重置 LeeClient 客户端环境')
        except Exception as _err:
            print('很抱歉, 重置 LeeClient 客户端环境的过程中发生了意外, 请检查结果')
            raise

    def menufuncSwitchWorkshop(self, clientver):
        '''
        重置工作区, 并切换 LeeClient 到指定的客户端版本
        '''
        if self.patchManager.canRevert():
            self.leeCommon.confirm([
                '在切换版本之前, 需要将 LeeClient 客户端恢复到干净状态',
                '请将自己添加的额外重要文件移出 LeeClient 目录, 避免被程序误删'
            ],
                                   title='切换主程序版本到 %s' % clientver,
                                   prompt='是否立刻执行重置操作?',
                                   inject=self,
                                   cancelExec='inject.menuitemExitAgent()',
                                   evalcmd='inject.menufuncResetWorkshop()')
            print(
                '----------------------------------------------------------------'
            )

        # 先执行与此版本相关的汉化工作
        print('正在汉化 iteminfo ...')
        LeeIteminfoTranslator().doTranslate(clientver)

        print('正在汉化 towninfo ...')
        LeeTowninfoTranslator().doTranslate(clientver)

        print('正在汉化 skillinfolist ...')
        LeeSkillinfolistTranslator().doTranslate(clientver)

        print('正在汉化 skilldescript ...')
        LeeSkilldescriptTranslator().doTranslate(clientver)

        print('正在汉化 客户端按钮 ...')
        LeeButtonTranslator().doTranslate(clientver)

        # 将对应的资源覆盖到 LeeClient 主目录
        print('正在切换版本, 请耐心等待...')
        if not self.patchManager.doApplyPatch(clientver):
            print('很抱歉, 切换仙境传说的主程序到 %s 版本的时发生错误, 请检查结果' % clientver)
        else:
            print('已切换仙境传说的主程序到 %s 版本\r\n' % clientver)

    def menufuncPackageSourceToZipfile(self, packageSourceDirname):
        '''
        将指定的打包源压缩成一个 ZIP 文件
        '''
        leeClientParantDir = self.leeCommon.client('..', withmark=False)
        packageSourceDirpath = '%s/%s' % (leeClientParantDir,
                                          packageSourceDirname)

        zipFilename = LeePublisher().getZipFilename(packageSourceDirpath)
        if not LeePublisher().makeZip(packageSourceDirpath, zipFilename):
            print('很抱歉, 压缩 ZIP 文件时发生错误, 请检查结果')
        else:
            print('已压缩为 ZIP 文件: %s\r\n' % (zipFilename))

    def menufuncPackageSourceToSetup(self, packageSourceDirname):
        '''
        将指定的打包源制作成一个 Setup 安装程序
        '''
        leeClientParantDir = self.leeCommon.client('..', withmark=False)
        packageSourceDirpath = '%s/%s' % (leeClientParantDir,
                                          packageSourceDirname)
        outputDirpath = './Output/%s' % packageSourceDirname

        if not LeePublisher().makeSetup(packageSourceDirpath, outputDirpath):
            print('很抱歉, 制作 Setup 安装程序时发生错误, 请检查结果')
        else:
            print('\r\n已制作完毕的 Setup 安装程序存放在: %s 目录中, 请确认.\r\n' %
                  (os.path.abspath(outputDirpath)))

    def menufuncUpdateButtonTranslateDB(self):
        '''
        根据目前各个客户端的 Resource/Original 目录中的最新文件
        来更新目前正在使用的按钮汉化数据库文件
        '''
        print('正在读取数据库...')
        self.buttonTranslator.load()
        print('正在根据目前 Patches 的内容升级数据库...')
        self.buttonTranslator.update()
        print('正在保存数据库...')
        self.buttonTranslator.save()
        print('更新操作已经完成, 请确认文件的变更内容...\r\n')

    def menufuncClientResourceVerifier(self):
        '''
        对客户端进行资源完整性校验
        '''
        self.leeVerifier.runVerifier()
        print('客户端文件完整性校验已结束\r\n')

    def menufuncBatchDecompileLub(self, lubSourceDirectory):
        '''
        将某个目录下的 lub 文件批量反编译
        需要让用户来选择这个目录的所在位置, 而不是一个固定位置
        '''
        print('您指定的目录为: %s' % lubSourceDirectory)

        if not self.leeCommon.isDirectoryExists(lubSourceDirectory):
            self.leeCommon.exitWithMessage('很抱歉, 你指定的目录不存在, 程序终止')

        if lubSourceDirectory.endswith('/') or lubSourceDirectory.endswith(
                '\\'):
            lubSourceDirectory = lubSourceDirectory[:-1]

        lubOutputDirectory = '%s%s%s' % (
            os.path.dirname(lubSourceDirectory), os.path.sep,
            os.path.basename(lubSourceDirectory) + '_output')
        print('计划的输出目录: %s' % lubOutputDirectory)

        if self.leeCommon.isDirectoryExists(lubOutputDirectory):
            self.leeCommon.exitWithMessage('发现输出目录已经存在, 请先手动删除后重试..')

        print('')
        LeeLua().decodeDir(lubSourceDirectory, lubOutputDirectory)

    def menufuncBatchAmendmentsLub(self):
        '''
        将 Patches 目录下的 lub 文件批量进行整理
        '''
        patchesDir = self.leeCommon.patches()

        for dirpath, _dirnames, filenames in os.walk(patchesDir):
            for filename in filenames:
                fullpath = os.path.normpath('%s/%s' % (dirpath, filename))
                if not filename.lower().endswith('.lub'):
                    continue
                if LeeLua().isTrulyLubFile(fullpath):
                    continue
                if not LeeLua().lubAmendments(fullpath, fullpath):
                    self.leeCommon.exitWithMessage('整理 %s 时发生错误, 请确认.' %
                                                   fullpath)
                else:
                    print('已整理: %s' % os.path.relpath(fullpath, patchesDir))

    def menufuncDetectLubCompiled(self):
        '''
        扫描整个 Patches 目录下的 lub 文件
        检测他们的是否已经被反编译, 并将没有被反编译的 lub 文件列出
        '''
        patchesDir = self.leeCommon.patches()

        print('正在扫描, 可能会花几分钟时间, 请耐心等待...')
        print('')
        work_start = timeit.default_timer()

        for dirpath, _dirnames, filenames in os.walk(patchesDir):
            for filename in filenames:
                fullpath = os.path.normpath('%s/%s' % (dirpath, filename))
                if not filename.lower().endswith('.lub'):
                    continue

                if LeeLua().isTrulyLubFile(fullpath):
                    print('尚未反编译 - %s' %
                          (os.path.relpath(fullpath, patchesDir)))

        work_elapsed = (timeit.default_timer() - work_start)

        print('扫描并检测完毕, 耗时: %0.2f 秒' % work_elapsed)
        print('')

    def menufuncDetectNonAnsiLub(self):
        '''
        扫描整个 Patches 目录下的 lub 文件
        检测他们的文件编码, 并列出非 ANSI 编码的文件
        '''
        patchesDir = self.leeCommon.patches()
        allowANSI = [
            'ASCII', 'EUC-KR', 'LATIN1', 'GBK', 'GB2312', 'CP949',
            'ISO-8859-1', 'WINDOWS-1252'
        ]

        print('正在扫描, 可能会花几分钟时间, 请耐心等待...')
        print('')
        work_start = timeit.default_timer()

        for dirpath, _dirnames, filenames in os.walk(patchesDir):
            for filename in filenames:
                fullpath = os.path.normpath('%s/%s' % (dirpath, filename))
                if not filename.lower().endswith('.lub'):
                    continue

                result, encoding = LeeLua().getLubEncoding(fullpath)
                if result and encoding not in allowANSI:
                    print('%s - %s' %
                          (encoding, os.path.relpath(fullpath, patchesDir)))

        work_elapsed = (timeit.default_timer() - work_start)

        print('扫描并检测完毕, 耗时: %0.2f 秒' % work_elapsed)
        print('')

    def menuitemUpdateButtonTranslateDB(self):
        '''
        菜单处理函数
        当选择“进行一些开发者维护工作 -> 汉化管理 - 更新按钮汉化数据库”时执行
        '''
        self.leeCommon.confirm(
            [
                '已汉化的内容将会被自动继承, 请不用担心',
                '涉及的数据库文件为: Resources/Databases/ButtonTranslate.json'
            ],
            title='更新客户端按钮的翻译数据库',
            prompt='是否执行更新操作?',
            inject=self,
            cancelExec='inject.menuitemExitAgent()',
            evalcmd='inject.menufuncUpdateButtonTranslateDB()')

    def menuitemStatisticsTranslateCoverage(self):
        '''
        菜单处理函数
        当选择“进行一些开发者维护工作 -> 汉化管理 - 汉化覆盖率统计”时执行
        '''
        self.leeCommon.exitWithMessage('此功能目前还在规划中, 待实现...')

    def menuitemClientResourceVerifier(self):
        '''
        菜单处理函数
        当选择“进行一些开发者维护工作 -> 资源管理 - 校验客户端资源完整性”时执行
        '''
        self.leeCommon.confirm(
            ['此过程可以协助排除可能的一些图档丢失情况.', '不过由于需要对客户端的大量文件进行判断, 时间可能会比较长.'],
            title='对客户端资源进行完整性校验',
            prompt='是否确认执行?',
            inject=self,
            cancelExec='inject.menuitemExitAgent()',
            evalcmd='inject.menufuncClientResourceVerifier()')

    def menuitemBatchDecompileLub(self):
        '''
        菜单处理函数
        当选择“进行一些开发者维护工作 -> 脚本管理 - 批量反编译某个目录中的 lub 文件”时执行
        '''
        self.leeCommon.input(
            [
                '您不能指望反编译后的 lua 文件可被 RO 客户端无错运行.',
                '反编译 lua 的函数时, 转换后的结果常出问题(语法错误), 需手动修正.', '',
                '请填写一个包含 lub 文件的 luafiles514 目录的完整路径.',
                '程序只转换后缀为 lub 的文件, 并将反编译后的文件保存到平级目录下.', '',
                '比如你填写的路径是: C:\\luafiles 那么输出会在 C:\\luafiles_output',
                '程序会将无需反编译的文件, 也一起复制到输出目录(保持目录结构).'
            ],
            title='批量反编译指定目录下的 lub 文件',
            prompt='请填写目录路径',
            inject=self,
            evalcmd='inject.menufuncBatchDecompileLub(user_input)')

    def menuitemBatchAmendmentsLub(self):
        '''
        菜单处理函数
        当选择“进行一些开发者维护工作 -> 脚本管理 - 批量整理某个目录中的 lub 文件”时执行
        '''
        self.leeCommon.confirm([
            '此操作会将 Patches 目录中的 lub 文件全部找出',
            '然后移除 lub 文件中的一些多余的注释, 并纠正一些格式错误等等.',
            '',
            '程序只转换后缀为 lub 的文件, 并将处理后的文件直接进行替换.',
            '注意: 由于会直接进行替换, 所以请您一定先自己做好备份! 避免意外.',
        ],
                               title='批量整理所有 lub 文件的内容',
                               prompt='是否立刻执行整理操作?',
                               inject=self,
                               cancelExec='inject.menuitemExitAgent()',
                               evalcmd='inject.menufuncBatchAmendmentsLub()')

    def menuitemDetectLubCompiled(self):
        '''
        菜单处理函数
        当选择“进行一些开发者维护工作 -> 脚本管理 - 扫描并列出所有未被反编译的 lub 文件”时执行
        '''
        self.leeCommon.confirm([
            '此操作会将 Patches 目录中的 lub 文件全部找出',
            '然后判断其是否已经被反编译, 并将没有被反编译的 lub 全部列出.', '',
            '注意: 为了提高效率, 我们只对文件后缀为 lub 的文件进行判断.'
        ],
                               title='扫描并列出所有未被反编译的 lub 文件',
                               prompt='是否立刻执行扫描操作?',
                               inject=self,
                               cancelExec='inject.menuitemExitAgent()',
                               evalcmd='inject.menufuncDetectLubCompiled()')

    def menuitemDetectNonAnsiLub(self):
        '''
        菜单处理函数
        当选择“进行一些开发者维护工作 -> 脚本管理 - 扫描并列出所有非 ANSI 编码的 lub 文件”时执行
        '''
        self.leeCommon.confirm([
            '此操作会将 Patches 目录中的 lub 文件全部找出',
            '然后探测其文件编码, 将所有非 ANSI 类型编码的文件都列出来.', '',
            '注意: GBK 和 EUC-KR 都属于 ANSI 类型编码, 而 UTF8 则不是.',
            '这里的 lub 文件实际上是 lua 的明文脚本文件.'
        ],
                               title='扫描并列出所有非 ANSI 编码的 lub 文件',
                               prompt='是否立刻执行扫描操作?',
                               inject=self,
                               cancelExec='inject.menuitemExitAgent()',
                               evalcmd='inject.menufuncDetectNonAnsiLub()')

    def menuitemBuildSourceUseGRF(self):
        '''
        菜单处理函数
        当选择“生成 / 打包 / 制作客户端安装程 -> 将当前客户端状态导出成打包源 ->
        将 data 目录压缩成 GRF (推荐)”时执行
        '''
        LeePublisher().makeSource(True)

    def menuitemBuildSourceDontUseGRF(self):
        '''
        菜单处理函数
        当选择“生成 / 打包 / 制作客户端安装程 -> 将当前客户端状态导出成打包源 ->
        不压缩 data 目录中的文件, 保持零散小文件状态 (不推荐)”时执行
        '''
        LeePublisher().makeSource(False)

    def menuitemConfrimDataFolderType(self):
        '''
        菜单处理函数
        当选择“生成 / 打包 / 制作客户端安装程 -> 将当前客户端状态导出成打包源”时执行
        '''
        self.leeCommon.menu([[
            '将 data 目录压缩成 GRF (推荐, 仅 Windows 支持)',
            'inject.menuitemBuildSourceUseGRF()'
        ],
                             [
                                 '不压缩 data 目录中的文件, 保持零散小文件状态 (不推荐)',
                                 'inject.menuitemBuildSourceDontUseGRF()'
                             ]],
                            title='生成打包源时, 您希望如何处理 data 目录:',
                            inject=self)

    def menuitemPackageSourceToZipfile(self):
        '''
        菜单处理函数
        当选择“生成 / 打包 / 制作客户端安装程 -> 选择一个打包源, 压缩成 ZIP 包”时执行
        '''
        packageSourceDirnameList = LeePublisher().getPackageSourceList(
            self.leeCommon.client('..'))
        if packageSourceDirnameList is None:
            self.leeCommon.exitWithMessage('很抱歉, 无法获取打包源列表, 程序终止')

        if not packageSourceDirnameList:
            self.leeCommon.exitWithMessage('没有发现任何可用的打包源, 请先生成一个吧')

        self.leeCommon.menu(
            [[x, 'inject.menufuncPackageSourceToZipfile(\'%s\')' % x]
             for x in packageSourceDirnameList],
            title='将指定的打包源压缩成 ZIP 文件',
            prompt='请选择你想压缩的打包源目录',
            inject=self,
            cancelExec='inject.entrance()',
            withCancel=True)

    def menuitemPackageSourceToSetup(self):
        '''
        菜单处理函数
        当选择“生成 / 打包 / 制作客户端安装程 -> 选择一个打包源, 制作游戏安装程序”时执行
        '''
        packageSourceDirnameList = LeePublisher().getPackageSourceList(
            self.leeCommon.client('..'))
        if packageSourceDirnameList is None:
            self.leeCommon.exitWithMessage('很抱歉, 无法获取打包源列表, 程序终止')

        if not packageSourceDirnameList:
            self.leeCommon.exitWithMessage('没有发现任何可用的打包源, 请先生成一个吧')

        self.leeCommon.menu(
            [[x, 'inject.menufuncPackageSourceToSetup(\'%s\')' % x]
             for x in packageSourceDirnameList],
            title='将指定的打包源制作成安装程序',
            prompt='请选择你想制作的打包源目录',
            inject=self,
            cancelExec='inject.entrance()',
            withCancel=True)

    def menuitemSwitchWorkshop(self):
        '''
        菜单处理函数
        当选择“切换客户端到指定版本”时执行
        '''
        clientList = self.leeCommon.getRagexeClientList(
            self.leeCommon.patches())
        if clientList is None:
            self.leeCommon.exitWithMessage('很抱歉, 无法获取客户端版本列表, 程序终止')

        menus = [[
            '切换到 %s 版本' % x,
            'inject.menufuncSwitchWorkshop(\'%s\')' % x
        ] for x in clientList]
        menus.insert(0, ['将客户端重置回干净状态', 'inject.menuitemResetWorkshop()'])

        self.leeCommon.menu(items=menus,
                            title='切换客户端到指定版本, 以便与服务端配套工作:',
                            inject=self,
                            cancelExec='inject.entrance()',
                            withCancel=True)

    def menuitemResetWorkshop(self):
        '''
        菜单处理函数
        当选择“切换客户端到指定版本 -> 将客户端重置回干净状态”时执行
        '''
        if self.patchManager.canRevert():
            self.leeCommon.confirm([
                '此操作可以将 LeeClient 客户端恢复到干净状态',
                '请将自己添加的额外重要文件移出 LeeClient 目录, 避免被程序误删.', '',
                '提醒: 此操作不会删除 Utility/Import 目录下的文件, 请放心.'
            ],
                                   title='将客户端重置回干净状态',
                                   prompt='是否立刻执行重置操作?',
                                   inject=self,
                                   cancelExec='inject.menuitemExitAgent()',
                                   evalcmd='inject.menufuncResetWorkshop()')
        else:
            self.leeCommon.exitWithMessage('您的客户端环境看起来十分干净, 不需要再进行清理了.')

    def menuitemMaintenance(self):
        '''
        菜单处理函数
        当选择“进行一些开发者维护工作”时执行
        '''
        self.leeCommon.menu(
            [['汉化管理 - 更新按钮汉化数据库', 'inject.menuitemUpdateButtonTranslateDB()'],
             [
                 '汉化管理 - 汉化覆盖率统计(计划实现)',
                 'inject.menuitemStatisticsTranslateCoverage()'
             ],
             ['资源管理 - 校验客户端资源完整性', 'inject.menuitemClientResourceVerifier()'],
             [
                 '脚本管理 - 批量反编译某个目录中的 lub 文件',
                 'inject.menuitemBatchDecompileLub()'
             ],
             [
                 '脚本管理 - 批量整理某个目录中的 lub 文件',
                 'inject.menuitemBatchAmendmentsLub()'
             ],
             [
                 '脚本管理 - 扫描并列出所有未被反编译的 lub 文件',
                 'inject.menuitemDetectLubCompiled()'
             ],
             [
                 '脚本管理 - 扫描并列出所有非 ANSI 编码的 lub 文件',
                 'inject.menuitemDetectNonAnsiLub()'
             ]],
            title='以下是一些开发者维护工作, 请选择您需要的操作:',
            inject=self)

    def menuitemMakePackageOrSetup(self):
        '''
        菜单处理函数
        当选择“生成 / 打包 / 制作客户端安装程序”时执行
        '''
        self.leeCommon.menu(
            [['将当前客户端状态导出成打包源', 'inject.menuitemConfrimDataFolderType()'],
             ['选择一个打包源, 压缩成 ZIP 包', 'inject.menuitemPackageSourceToZipfile()'],
             [
                 '选择一个打包源, 制作游戏安装程序 (仅 Windows 平台支持)',
                 'inject.menuitemPackageSourceToSetup()'
             ]],
            title='生成 / 打包 / 制作客户端安装程序, 请选择您需要的操作:',
            inject=self)

    def menuitemExitAgent(self):
        '''
        菜单处理函数
        当选择“退出程序”时执行
        '''
        self.leeCommon.exitWithMessage('感谢您的使用, 再见')

    def entrance(self):
        '''
        菜单处理函数
        这里是主菜单的入口处
        '''
        self.leeCommon.menu(
            [['切换客户端到指定版本', 'inject.menuitemSwitchWorkshop()'],
             ['生成 / 打包 / 制作客户端安装程序', 'inject.menuitemMakePackageOrSetup()'],
             ['进行一些开发者维护工作', 'inject.menuitemMaintenance()'],
             ['退出程序', 'inject.menuitemExitAgent()']],
            title='您好, 欢迎使用 LeeClientAgent 来管理您的客户端!',
            inject=self)
コード例 #2
0
ファイル: LeePublisher.py プロジェクト: lth1986/LeeClient
class LeePublisher:
    def __init__(self):
        self.leeCommon = LeeCommon()
        self.leeConfig = LeeConfigure()
        self.patchManager = LeePatchManager()

    def removeOldGrf(self):
        leeClientDir = self.leeCommon.client(withmark=False)
        grfFiles = glob.glob('%s/*.grf' % leeClientDir)

        for filepath in grfFiles:
            os.remove(filepath)

    def ensureHasGRF(self):
        leeClientDir = self.leeCommon.client(withmark=False)

        if LeeGrf().isGrfExists():
            reUseExistsGrfFiles = self.leeCommon.confirm(
                [
                    '当前客户端目录已经存在了 Grf 文件', '请问是直接使用他们(y), 还是需要重新生成(n)?', '',
                    '注意: 若选重新生成(n), 那么目前的 Grf 文件将被立刻删除.'
                ],
                title='文件覆盖确认',
                prompt='是否继续使用这些 Grf 文件?',
                inject=self,
                cancelExec='inject.removeOldGrf()',
                evalcmd=None)

            if reUseExistsGrfFiles:
                return

        LeeGrf().makeGrf('%s/data' % leeClientDir,
                         '%s/data.grf' % leeClientDir)

        if not LeeGrf().isGrfExists():
            self.leeCommon.exitWithMessage(
                '请先将 data 目录打包为 Grf 文件, 以便提高文件系统的复制效率.')

    def makeSource(self, useGrf):
        '''
        将 LeeClient 的内容复制到打包源目录(并删除多余文件)
        '''
        leeClientDir = self.leeCommon.client(withmark=False)
        packageSourceCfg = self.leeConfig.get('PackageSource')

        # 判断是否已经切换到某个客户端版本
        if not self.patchManager.canRevert():
            self.leeCommon.exitWithMessage(
                '请先将 LeeClient 切换到某个客户端版本, 否则制作出来的 grf 内容不完整.')

        if useGrf:
            self.ensureHasGRF()

        # 判断磁盘的剩余空间是否足够
        currentDriver = self.leeCommon.utility()[0]
        currentFreeSpace = self.leeCommon.getDiskFreeSpace(currentDriver)
        if currentFreeSpace <= 1024 * 1024 * 1024 * 4:
            self.leeCommon.exitWithMessage('磁盘 %s: 的空间不足 4 GB, 请清理磁盘释放更多空间.' %
                                           currentDriver)

        # 生成一个 LeeClient 平级的发布目录
        nowTime = time.strftime("%Y%m%d_%H%M%S", time.localtime())
        releaseDirName = 'LeeClient_Release_%s' % nowTime
        releaseDirpath = self.leeCommon.client('../' + releaseDirName,
                                               withmark=False)

        # 先列出需要复制到打包源的文件列表
        filterDirectories = ['Utility', '.git', '.vscode']
        filterFiles = ['.gitignore', '.DS_Store']

        # 若使用 grf 文件的话, 则排除掉 data 目录
        if useGrf:
            filterDirectories.append('data')

        print('正在分析需要复制的文件, 请稍后...')
        copyFileList = []
        for dirpath, dirnames, filenames in os.walk(leeClientDir):
            for filename in filenames:
                fullpath = os.path.join(dirpath, filename)

                # 过滤一下不需要导出的目录 (大小写敏感)
                dirnames[:] = [
                    d for d in dirnames if d not in filterDirectories
                ]

                # 过滤一下不需要导出的文件 (不区分大小写)
                isBlocked = False
                for filterFile in filterFiles:
                    if filterFile.lower() in filename.lower():
                        isBlocked = True
                        break
                if isBlocked:
                    continue

                # 判断是否需要移除调试版的登录器主程序
                if filename.lower().endswith(
                        '.exe') and '_ReportError.exe' in filename:
                    if packageSourceCfg['AutoRemoveDebugClient']:
                        continue

                # 记录到 copyFileList 表示需要复制此文件到打包源
                copyFileList.append(fullpath)

        print('分析完毕, 共需复制 %d 个文件, 马上开始.' % len(copyFileList))

        # 确定游戏启动入口的相对路径
        srcClientName = packageSourceCfg['SourceClientName']
        pubClientName = packageSourceCfg['PublishClientName']

        if packageSourceCfg['SourceClientName'] == 'auto':
            for srcFilepath in copyFileList:
                if not srcFilepath.lower().endswith('.exe'):
                    continue
                filename = os.path.basename(srcFilepath)
                if '_patched.exe' in filename:
                    srcClientName = filename
                    break

        # 把文件拷贝到打包源
        # TODO: 最好能够显示文件的复制进度
        # http://zzq635.blog.163.com/blog/static/1952644862013125112025129/
        for srcFilepath in copyFileList:
            # 获取相对路径, 用于复制到目标文件时使用
            relFilepath = os.path.relpath(srcFilepath, leeClientDir)

            # 构建复制到的目标文件全路径
            dstFilepath = '%s/%s' % (releaseDirpath, relFilepath)

            # 对游戏的入口程序进行重命名操作
            bIsSourceClient = False
            if srcFilepath.lower().endswith('.exe'):
                if os.path.basename(srcFilepath) == srcClientName:
                    bIsSourceClient = True
                    dstFilepath = self.leeCommon.replaceBasename(
                        dstFilepath, pubClientName)

            print('正在复制: %s%s' % (relFilepath, ' (%s)' %
                                  pubClientName if bIsSourceClient else ''))
            os.makedirs(os.path.dirname(dstFilepath), exist_ok=True)
            shutil.copyfile(srcFilepath, dstFilepath)

        # 把最终发布源所在的目录当做参数返回值回传
        return releaseDirpath

    def getZipFilename(self, sourceDir):
        if sourceDir.endswith('\\') or sourceDir.endswith('/'):
            sourceDir = sourceDir[:-1]
        return '%s.zip' % sourceDir

    def getPackageSourceList(self, dirpath):
        '''
        根据指定的 dir 中枚举出子目录的名字 (即打包源的目录名)
        返回: Array 保存着每个子目录名称的数组
        '''
        dirlist = []
        osdirlist = os.listdir(dirpath)

        for dname in osdirlist:
            if not dname.lower().startswith('leeclient_release_'):
                continue
            if os.path.isdir(os.path.normpath(dirpath) + os.path.sep + dname):
                dirlist.append(dname)

        dirlist.sort()
        return dirlist

    def makeZip(self, sourceDir, zipSavePath):
        '''
        将打包源目录直接压缩成一个 zip 文件
        '''
        # https://blog.csdn.net/dou_being/article/details/81546172
        # https://blog.csdn.net/zhd199500423/article/details/80853405

        zipCfg = self.leeConfig.get('ZipConfigure')
        return LeeZipfile().zip(sourceDir, zipSavePath,
                                zipCfg['TopLevelDirName'])

    def makeSetup(self, sourceDir, setupOutputDir=None):
        '''
        将打包源目录直接制作成一个 Setup 安装程序
        '''
        if setupOutputDir is None:
            setupOutputDir = './Output'

        sourceDir = os.path.abspath(sourceDir)
        setupOutputDir = os.path.abspath(setupOutputDir)

        # 判断 InnoSetup 是否已经安装
        if not self.__isInnoSetupInstalled():
            # 若未安装则进行安装 (此处需要管理员权限)
            if self.__instInnoSetup():
                # 安装后将补丁文件复制到 InnoSetup 的安装目录中
                self.__applyInnoSetupLdrPatch()
            else:
                self.leeCommon.exitWithMessage('无法成功安装 Inno Setup, 请联系作者进行排查')

        # 再次进行环境检查, 确保一切就绪
        if not self.__checkInnoSetupStatus():
            self.leeCommon.exitWithMessage('本机的 Inno Setup 环境不正确, 无法继续进行工作.')

        # 读取目前的配置值, 请求用户确认后继续
        configure = self.__choiceConfigure()
        if configure is None:
            self.leeCommon.exitWithMessage('您没有确定用于生成 Setup 的配置, 无法继续进行工作.')

        # 若是第一次使用, 则需要帮用户生成一个 GUID 并嘱咐用户保存 GUID
        if str(configure['LeeAppId']).lower() == 'none':
            # 需要帮用户初始化一个 AppId 并告知用户记录好这个值
            print('发现配置 “%s” 的 LeeAppId 值为 None' % configure['LeeName'])
            print('您必须为其分配一个 GUID. 程序已为您自动生成了一个 GUID:')
            print('')
            print(str(uuid.uuid1()).upper())
            print('')
            print('请复制后粘贴到 LeeClientAgent.yml 文件中 SetupConfigure 节点的')
            print('对应选项里面替换掉 None 值, 然后再重试一次.')
            print('')
            self.leeCommon.pauseScreen()
            sys.exit(0)

        # 在 configure 中补充其他参数
        configure['LeePackageSourceDirpath'] = sourceDir
        configure['LeeOutputDir'] = setupOutputDir
        configure['LeeAppId'] = (r'{{%s}' % configure['LeeAppId']).upper()

        # 确认打包源中配置里填写的“主程序”和“游戏设置程序”都存在, 不在则中断
        leeAppExePath = os.path.abspath(
            '%s/%s' % (sourceDir, configure['LeeAppExeName']))
        leeGameSetupExePath = os.path.abspath(
            '%s/%s' % (sourceDir, configure['LeeGameSetupExeName']))
        if not self.leeCommon.isFileExists(leeAppExePath):
            self.leeCommon.exitWithMessage(
                'LeeAppExeName 指向的主程序 %s 不在打包源目录中: %s' %
                (configure['LeeAppExeName'], sourceDir))
        if not self.leeCommon.isFileExists(leeGameSetupExePath):
            self.leeCommon.exitWithMessage(
                'leeGameSetupExePath 指向的主程序 %s 不在打包源目录中: %s' %
                (configure['LeeGameSetupExeName'], sourceDir))

        # 读取脚本模板
        scriptTemplateContent = self.__readScriptTemplate()

        # 根据配置进行配置项的值替换
        scriptFinallyContent = self.__generateFinallyScript(
            scriptTemplateContent, configure)

        # 将最终的脚本保存到临时目录中
        scriptCachePath = self.__saveFinallyScriptToCache(scriptFinallyContent)

        # 调用 ISCC.exe 执行 Setup 的打包操作
        return self.__runInnoScript(scriptCachePath)

    def __isInnoSetupInstalled(self):
        '''
        判断 Inno Setup 是否已经安装到电脑中
        '''
        innoSetupDir = self.__getInnoSetupInstallPath()
        if innoSetupDir is None:
            return False
        return self.leeCommon.isFileExists('%sCompil32.exe' % innoSetupDir)

    def __getInnoSetupInstallPath(self):
        '''
        获取 Inno Setup 的安装目录, 末尾自动补斜杠
        '''
        try:
            if platform.system() != 'Windows':
                self.leeCommon.exitWithMessage(
                    '很抱歉, %s 此函数目前只能在 Windows 平台上运行.' %
                    sys._getframe().f_code.co_name)

            # 根据不同的平台切换注册表路径
            if platform.machine() == 'AMD64':
                innoSetup_key = winreg.OpenKey(
                    winreg.HKEY_LOCAL_MACHINE,
                    'SOFTWARE\\WOW6432Node\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\Inno Setup 5_is1'
                )
            else:
                innoSetup_key = winreg.OpenKey(
                    winreg.HKEY_LOCAL_MACHINE,
                    'SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\Inno Setup 5_is1'
                )

            # 读取 Inno Setup 的安装目录
            installLocation, _value_type = winreg.QueryValueEx(
                innoSetup_key, 'InstallLocation')
            if not (installLocation.endswith('\\')
                    or installLocation.endswith('/')):
                installLocation = '%s%s' % (installLocation, os.path.sep)

            return installLocation
        except Exception as _err:
            return None

    def __applyInnoSetupLdrPatch(self):
        '''
        应用 SetupLdr.e32 补丁到 Inno Setup 的安装目录下 (要求管理员权限)
        '''
        # 此过程要求管理员权限, 看看如何检测一下
        if not self.leeCommon.isAdministrator():
            self.leeCommon.exitWithMessage('此操作要求程序“以管理员权限运行”, 请重试.')

        scriptDir = self.leeCommon.utility(withmark=False)
        innoSetupDir = self.__getInnoSetupInstallPath()

        if innoSetupDir is None:
            return False

        srcFilepath = ('%s/Bin/InnoSetup/Resources/Installer/SetupLdr.e32' %
                       scriptDir).replace('/', os.path.sep)
        dstFilepath = ('%sSetupLdr.e32' % innoSetupDir)
        bakFilepath = ('%sSetupLdr.e32.bak' % innoSetupDir)

        if (not self.leeCommon.isFileExists(bakFilepath)
            ) and self.leeCommon.isFileExists(dstFilepath):
            shutil.copyfile(dstFilepath, bakFilepath)

        if not self.leeCommon.isFileExists(srcFilepath):
            return False
        os.remove(dstFilepath)
        shutil.copyfile(srcFilepath, dstFilepath)

        return True

    def __checkInnoSetupStatus(self):
        '''
        检查 Inno Setup 的状态是否正常且符合要求
        '''
        innoSetupDir = self.__getInnoSetupInstallPath()
        if innoSetupDir is None:
            return False

        # Inno Setup 是否已经安装
        if not self.__isInnoSetupInstalled():
            return False

        # Inno Setup 的 ISCC.exe 是否存在
        if not self.leeCommon.isFileExists('%sISCC.exe' % innoSetupDir):
            return False

        # 是否已经安装了 SetupLdr.e32 补丁
        setupLdrMD5 = self.leeCommon.getMD5ForSmallFile('%sSetupLdr.e32' %
                                                        innoSetupDir)
        if setupLdrMD5 != '544dbcf30c8ccb55082709b095173f6c':
            return False

        return True

    def __instInnoSetup(self):
        '''
        安装 Inno Setup 并确保安装成功 (要求管理员权限)
        '''
        # 此过程要求管理员权限, 在此进行检查
        if not self.leeCommon.isAdministrator():
            self.leeCommon.exitWithMessage('此操作要求程序“以管理员权限运行”, 请重试.')

        # 先确认 Inno Setup 的安装程序是否存在
        scriptDir = self.leeCommon.utility(withmark=False)
        installerFilepath = (
            '%s/Bin/InnoSetup/Resources/Installer/innosetup-5.6.1-unicode.exe'
            % scriptDir).replace('/', os.path.sep)
        if not self.leeCommon.isFileExists(installerFilepath):
            return False

        # 执行静默安装过程
        setupProc = subprocess.Popen('%s /VERYSILENT' % installerFilepath,
                                     stdout=sys.stdout,
                                     cwd=os.path.dirname(installerFilepath))
        setupProc.wait()

        # 确认结果并输出提示信息表示压缩结束
        return setupProc.returncode == 0 and self.__isInnoSetupInstalled()

    def choiceExit(self):
        print('不选择任何一个配置的话, 无法继续工作, 请重试.')

    def __choiceConfigure(self):
        '''
        让用户选择一个生成 Setup 的配置
        '''
        # 读取现在的所有 setup 配置
        setupCfg = self.leeConfig.get('SetupConfigure')

        # 若只有一个配置, 则直接选中这个配置, 进入用户确认阶段
        if len(setupCfg) > 1:
            # 列出来让用户进行选择, 选中哪个就把配置读取出来返回
            menus = []
            for cfgKey, cfgValue in enumerate(setupCfg):
                menuItem = [cfgValue['LeeName'], None, cfgKey]
                menus.append(menuItem)

            configure = self.leeCommon.menu(items=menus,
                                            title='选择生成配置',
                                            prompt='请选择用于生成安装程序的配置',
                                            inject=self,
                                            cancelExec='inject.choiceExit()',
                                            withCancel=True,
                                            resultMap=setupCfg)
        else:
            configure = setupCfg[0]

        # 把配置内容列出来让用户进行最终确认
        lines = self.__getConfigureInfos(configure)
        title = '确认配置的各个选项值'
        prompt = '是否继续?'

        if not self.leeCommon.confirm(lines, title, prompt, None, None, None):
            self.leeCommon.exitWithMessage('感谢您的使用, 再见')

        return configure

    def __getConfigureInfos(self, configure, dontPrint=True):
        '''
        给定一个配置的字典对象, 把内容构建成可读样式, 必要的话打印出来
        '''
        configureInfos = [
            '配置名称(LeeName): %s' % configure['LeeName'],
            '安装包唯一编号(LeeAppId): %s' % configure['LeeAppId'],
            '游戏名称(LeeAppName): %s' % configure['LeeAppName'],
            '游戏主程序(LeeAppExeName): %s' % configure['LeeAppExeName'],
            '安装包版本号(LeeAppVersion): %s' % configure['LeeAppVersion'],
            '安装包发布者(LeeAppPublisher): %s' % configure['LeeAppPublisher'],
            '发布者官网(LeeAppURL): %s' % configure['LeeAppURL'],
            '开始菜单程序组名称(LeeDefaultGroupName): %s' %
            configure['LeeDefaultGroupName'],
            '设置程序在开始菜单的名称(LeeGameSetupName): %s' %
            configure['LeeGameSetupName'],
            '设置程序在安装目录中的实际文件名(LeeGameSetupExeName): %s' %
            configure['LeeGameSetupExeName'],
            '安装时的默认目录名(LeeDefaultDirName): %s' %
            configure['LeeDefaultDirName'],
            '最终输出的安装程序文件名(LeeOutputBaseFilename): %s' %
            configure['LeeOutputBaseFilename'],
            '----------------------------------------------------------------',
            '若想修改以上选项的值, 或者想对他们的作用有更详细的了解, 请编辑',
            'Utility 目录下的 LeeClientAgent.yml 配置文件.',
            '----------------------------------------------------------------'
        ]

        if not dontPrint:
            print('\r\n'.join(configureInfos))
        return configureInfos

    def __readScriptTemplate(self):
        '''
        获取 Inno Setup 的脚本模板并作为字符串返回
        '''
        scriptDir = self.leeCommon.utility(withmark=False)
        scriptTemplateFilepath = (
            '%s/Bin/InnoSetup/Resources/Scripts/Scripts_Template.iss' %
            scriptDir).replace('/', os.path.sep)

        if not self.leeCommon.isFileExists(scriptTemplateFilepath):
            return None
        return open(scriptTemplateFilepath, 'r', encoding='utf-8').read()

    def __generateFinallyScript(self, templateContent, configure):
        '''
        把配置套到模板中, 并将处理后的脚本内容返回
        '''
        finallyContent = templateContent

        for k, v in configure.items():
            if v is None:
                continue
            rePattern = '(#define %s ".*?")' % k
            searchResult = re.search(rePattern, finallyContent)
            if searchResult is None:
                continue
            finallyContent = finallyContent.replace(searchResult.group(0),
                                                    '#define %s "%s"' % (k, v))

        return finallyContent

    def __saveFinallyScriptToCache(self, finallyContent):
        '''
        将给定的最终脚本内容保存到一个临时目录中, 并返回脚本的全路径
        '''
        scriptDir = self.leeCommon.utility(withmark=False)
        scriptCacheDir = ('%s/Bin/InnoSetup/Cache/' % scriptDir).replace(
            '/', os.path.sep)
        os.makedirs(scriptCacheDir, exist_ok=True)

        contentHash = self.leeCommon.getMD5ForString(finallyContent)
        scriptCachePath = os.path.abspath('%s%s.iss' %
                                          (scriptCacheDir, contentHash))

        if self.leeCommon.isFileExists(scriptCachePath):
            os.remove(scriptCachePath)

        # 这里保存脚本文件的时候必须用 UTF8 with BOM (对应的 encoding 为 utf-8-sig)
        # 否则 Inno Setup 引擎将无法识别出这是 UTF8 编码, 从而改用 ANSI 去解读脚本文件
        # 最后导致的结果就是中文快捷方式的名称直接变成了乱码
        cfile = open(scriptCachePath, 'w+', encoding='utf-8-sig')
        cfile.write(finallyContent)
        cfile.close()

        return scriptCachePath

    def __runInnoScript(self, scriptPath):
        '''
        调用 ISCC.exe 进行安装程序的制作, 同步等待结束
        '''
        innoSetupDir = self.__getInnoSetupInstallPath()
        if innoSetupDir is None:
            return False

        isccPath = '%sISCC.exe' % innoSetupDir
        if not self.leeCommon.isFileExists(isccPath):
            return False

        isccProc = subprocess.Popen('%s "%s"' % (isccPath, scriptPath),
                                    stdout=sys.stdout,
                                    cwd=os.path.dirname(scriptPath))
        isccProc.wait()

        return isccProc.returncode == 0