准备工作

在进行转换工作前，你需要以下网站和应用：

1. svg转换png工具
2. 图片裁剪工具
3. flathub
4. 玲珑包使用文档
5. 最新版本的玲珑（截至2025.9.6，最新版本为1.9.9）
6. 运营给的自动化测试工具

如果你准备参加论坛开展的2025年第1期「玲珑应用迁移与开发征募赛」，请先注册一个统信开发者帐号以便进行接下来的投稿。

为更直观的进行玲珑应用包转换工作，推荐将文件夹放置在在同一个目录下。

开始转换

自动转换

转换应用将要用到以下几个文件夹：

1. 一个用于存放转换应用的文件夹，示例如 /home//Documents/linglong
2. 将需要进行兼容性检测的玲珑应用安装包"layer"文件放置到任意具有读取权限的非ntfs目录中。示例如 /home//Documents/ll_origin
3. 在任意具有读写权限的非ntfs目录中创建两个具备读写权限的目录用于放置整理后的玲珑应用安装包"layer"文件和应用图标。示例如 /home//Documents/ll_pool``/home//Documents/ll_res

接下来你应当在flathub中找到你所要转换的软件包并将其flatpakID复制下来，并将其填入ll-pica-flatpak convert命令中，我这里使用PDFedit的ID：

(25425) ./apps/ll-builder/src/main.cpp:338 Layer export completed successfully.

若转换成功，则终端输出：(25425) ./apps/ll-builder/src/main.cpp:338 Layer export completed successfully.

在转换完成后，终端所在目录下会出现对应的文件夹，文件夹名称为转换的faltpakID，如：net.sourceforge.Pdfedit

进入对应应用的转换文件夹，其中会有两个包：net.sourceforge.Pdfedit_1.0.0.0_x86_64_binary.layer和 net.sourceforge.Pdfedit_1.0.0.0_x86_64_develop.layer

我们最终投递是用的binary后缀的玲珑包，这里我们将转换完成后的文件放入 ll_origin文件夹，然后在测试工具所在目录中打开终端，输入命令 ./linyaps-auto-optimize.sh /home//Documents/ll_origin /home//Documents/ll_pool，此时自动化测试工具会将 ll_origin内的应用包整理好后存放至 ll_pool文件夹内。

整理完成后执行安装操作 ./linyaps-auto-install.sh /home//Documents/ll_pool

安装完成后执行测试操作 ./linyaps-auto-testing.sh /home//Documents/ll_res

测试时应将所有窗口关闭，将终端最小化以避免对测试结果造成干扰。

手动转换

由于截至2025.9.6，玲珑环境仍然没有gnome48.0，因而在打包部分gnome flatpak时会出现无法生成结果的问题。我们可以采取手动编译的方式来解决这个问题，但请注意，该方法仅适用于简单的gnome应用，较为复杂的gnome应用用这种方法打出来的包不一定可以正常运行。

首先进入对应应用文件夹，删除其中的linglong文件夹，然后修改文件内的linglong.yaml​文件，修改其中的base:，将gnome后的版本号从48改为47。接下来在文件夹内打开终端，输入ll-builder build​，待编译完成后输入ll-builder export --layer​导出layer包，随后可按照正常测试流程进行测试。

特别说明：该方法不保证百分百成功，因而若手动转换后的应用无法正常启动，可以考虑手动补充依赖或等待玲珑环境更新再进行转换。

投递应用

那么现在你已经完成了flatpak应用至玲珑应用的转换，可以开始投递应用了。

你需要准备以下投递所需材料：

1. 三张应用截图（大小可选1050x700或1920x1280
2. 一个翻译软件，用于翻译应用的英文介绍。
3. 一张待投递应用的软件图标，通常可以在ll_res文件夹内获得，若文件夹内图标为svg图片，可使用本文开头所给的转换网站或其他工具进行转换后再提交。

为了保证你投递的应用可以一次性通过审核，投递的时候应注意以下事项：

1. 将上架地区全部勾选
2. 默认语言为中文（简体），中英文介绍都要写
3. 一段足够长的应用介绍，大概100字以上即可。
4. 将应用的系统版本管理中的三个选项（V23社区版，V25社区版，V25专业版）全部勾上。
5. 不要完全依赖自动测试套件，自动测试套件并不一定完全准确，有时可能会出现测试结果与实际运行结果不符的情况。

若所有材料都填充完毕，就可以投递审核了。如果有关于转换应用的其他问题，欢迎在评论区里提出。