就目前而言，玲珑格式包迁移分为两种类型。第一种为deb转制迁移，第二种为由源码构建。本文介绍的是第一种由deb转制迁移为玲珑格式的教程，小白都可以轻松上手。至于完整的玲珑相关教程文档，可以查看玲珑官网使用手册。

第一步：前期准备

1. 一个已经安装linglong-bin >= 1.5.0的deepin 23或UOS 1070系统环境
   参考文档:https://linglong.dev/guide/start/install.html

2. 安装linglong-pica转换工具，参考文档:https://linglong.dev/guide/ll-pica/introduction.html

3. 下载迁移脚本，搭配ll-pica版本号=1.1.1-1使用（新增适配版本检测、新增layer生成检测，若layer生成失败则不会继续运行，减少干扰调试信息），下载：linglong-convert.tar.zip

4. 新建一个本地的玲珑工作文件目录，用于进行玲珑转换操作，具体目录位置自行决定，创建后复制目录的绝对路径
   路径复制参考如下：打开新建目录，在文件管理器顶部标签区域右键选择编辑地址，全选复制后即可得到本目录的绝对路径

   

5. 注意，需要构建设备全程联网

第二步：挑选需要转换为玲珑格式的应用

1. 打开应用商店，搜索并进入需要转换为玲珑格式的应用所属详情页，点击"版本"旁边的切换符号，即可显示该应用的应用包名

   

2. 点击复制包名，即可将该应用的应用包名复制到剪贴板中

   

第三步：修改脚本内容

1. 单击选中迁移脚本"auto_convert.sh"，右键使用文本编辑器打开该脚本工具

2. 找到"LINGLONG_WORK_DIR"变量项，将第一步中创建的玲珑工作目录路径粘贴到引号中，替代原有示例路径

3. 找到"PKG_NAME"变量项，将第二步中获取的应用包名粘贴到引号中，替代原有示例值

   

4. 请注意2、3步皆不要误删引号

5. 修改完成，保存脚本文件即可

第四步：执行转换操作

1. 运行脚本：返回脚本所在目录，双击脚本打开后选择"在终端中运行"

   

2. 自动打包：终端将自动执行构建任务，构建完毕后会在第一步创建的玲珑工作目录文件夹中对应本次转换应用包名的目录内生成一个以".runtime.layer"为后缀的玲珑运行文件(这个layer文件就是最终可上架商店的玲珑格式包)

3. 运行调试：完成第2步打包任务后，终端会继续执行调试任务，若应用能正常运行则会自动打开应用运行界面（一般而言5分钟未能调起应用则视为迁移任务失败，应用不可用）

4. 手动测试：可对第3步成功运行的应用进行手动测试，测试完毕后关闭应用即可

常见问题

1. 目前仅支持转换应用商店在架的应用，其他来源的deb安装包转换支持正在适配中
2. 若对应应用包名的文件夹内已经生成以".layer"为后缀的玲珑运行文件，但应用超过5分钟仍无法成功启动界面或终端调试界面中出现error类报错信息，则表示当前玲珑应用构建成功但运行失败。如遇此类问题，请加入“玲珑生态共建小组”进行反馈、交流
3. 通过本脚本转换出来的玲珑运行文件名应为"原包名.linyaps.runtime.layer"，若发现构建完成的玲珑运行文件名不符合该标准，请删除该应用的工作目录后重新转换构建该应用并通过“玲珑生态共建小组”进行反馈、交流

相关链接：

了解玲珑：《开发赋能共建玲珑生态》分享直播会回看

玲珑《使用手册》

玲珑生态共建小组管理办法

2024年第1期 “玲珑”应用迁移与开发征募赛