Unity开发者联盟收藏本站
发帖教程新人必读切换到宽版

 找回密码
 立即注册
Unity开发者联盟»论坛 › 3D Answers 技术讨论 › 技术讨论 Technology Answers › Unity转微信小游戏之Puerts快速上手指南
返回列表 发新帖
查看: 457|回复: 0

Unity转微信小游戏之Puerts快速上手指南

[复制链接]
发表于 2022-12-19 16:49 | 显示全部楼层 |阅读模式
最近小游戏比较火，腾讯放开了入口，而腾讯与之相关的建设也完善起来。

虽然有现成的解决方法，但要自己重头搭起来还是要踩不少坑的，所以抽时间撸了一个脚手架工具。可以极大减化上手成本。
项目地址：https://github.com/sbfkcel/puerts_cli
开箱即用的 PuerTS 脚手架工具，通过本工具可以将 Puerts 快速接入并应用于项目中。

功能特点：
    基于 SWC 构建的编译环境，快如闪电无需再手动搭建 Typescript、Webpack 相关编译及打包环境开箱即用的 Souremap、Hot reload、断点调试 等配置集成快速编译 Puerts WebGL 运行时，并能自动完成与Web或微信小游戏项目的对接Web、微信小游戏工程拥有编译与预览一体的环境，无需自行再搭建预览环境
现阶段仅支持 Unity 项目
安装


确保本地已经安装 Node.js 16.15.0+
# 使用npm安装npm install @puerts/cli -g# 使用yarn安装yarn global add @puerts/cli# 输出版本号，检查是否安装成功puer -v帮助手册


Puerts Cli 自带帮助手册，通过添加 --help 参数来查看每个命令及相关参数的帮助说明。
# 查看当前可用的命令puer -h# 查看 build 命令使用参数puer build -h# ...新手教程

    使用 Unity 2021+ LTS 创建一个空项目在项目中添加 Puerts
      下载 Puerts解压并将 Puerts 目录复制到项目的 Assets/ 目录下，即：Assets/Puerts/
    • 注意：由于 Puerts 支持多系统多平台，需要手动指定好哪些文件适用于哪些平台，否则可能运行或编译出现异常，具体操作方法如下：
        UnityEditor的资源管理器中找到: Assets -> Puerts -> Plugins -> xx系统 -> xx 直到具体的文件，选中目录下所有文件然后在 Inspector 面板勾选对上的平台并点击 Apply 按钮（至少保证当前 Editor 环境有选择对，其它如果不知道则全都不选就好，之后等需要编译对应平台的时候再来这里设置）设置完之后，建议关掉 UnityEditor 重开一次
      下载 PuertsWebGL 并解压在解压目录内找到 package 目录并重命名为 PuertsWebGL将重命名好的 PuertsWebGL 目录复制到项目的 Assets/ 目录下，即：Assets/PuertsWebGL/

  • 在项目中添加 微信小游戏转换工具（无需支持 Web、微信小游戏可以忽略）
      下载微信小游戏转换工具Unity插件双击 minigame.xxx.unitypackage 将插件导入到项目

  • 初始化 Puerts 项目
      终端进入到创建好的 Unity项目 目录中终端执行 puer init 初始化一个 Puerts 项目

  • 将项目色彩空间改为 Gamma（无需支持 Web、微信小游戏可以忽略）
      UnityEditor菜单 -> Editor -> Project Settings -> Player -> Other Settings -> Color Space -> Gamma

  • 允许不安全代码（Blittables 需要用到）
      UnityEditor菜单 -> Editor -> Project Settings -> Player -> Other Settings -> Allow 'unsafe' Code
    使用 Puerts 生成关联 Code
      UnityEditor菜单 -> PuerTS -> Clear Generated CodeUnityEditor菜单 -> PuerTS -> Generated CodeUnityEditor菜单 -> PuerTS -> Generated index.d.ts (global.CS style)

  • 编译 Puerts 项目
      终端进入到创建好的 Unity项目 目录中终端执行 puer build，工具会将项目所有的 TS 文件编译为 JS

  • 预览项目
      使用 Unity Editor 打开项目双击 Assets/Scenes/App.unity 场景点击 Play 即可看到运行效果

  • 进入开发模式
      终端进入到创建好的 Unity项目 目录中终端执行 puer dev，此时工具会监听项目中的 TS 文件是否有修改，如有修改则会实时将其编译为 JS 文件

编译为Web或微信小游戏工程


  • 导出 Web 或 微信小游戏工程
      确保 UnityEditor 有安装 Unity-WebGL-Support确保项目已经有安装 PuertsWebGL、微信小游戏转换工具
    • 添加需要导出的 Scene
        UnityEditor 打开需要导出的场景UnityEditor菜单 File -> Build Settings -> Add Open Scenes

    • UnityEditor菜单 微信小游戏 -> 转换小游戏 在弹出的转换窗口中填写以下信息
        游戏appid，在微信公众平台中申请小游戏项目名称，随便填写游戏资源CDN，填写 http://localhost:10000（这也是 cli 工具默认的 Web 项目预览地址，CDN资源也就是这里的资源）
      • 导致路径，这里建议与 puer.config.js 中的 minigameOutputDir 配置项目保持一致
          puer.config.js 文件在执行 puer init 时会自动创建，文件默认位置：项目/TS/puer.config.jsminigameOutputDir 默认为 桌面/项目目录名称/

      • 点击 导出WEBGL并转换为小游戏（常用按钮） 导出项目
          如果导出遇到错误，请根据 UnityEditor Console 面板中的提示排除故障



  • 编译 puerts 运行时并对接
      终端 cd Unity项目目录终端 puer build --target minigame --browse
        脚手架会编译 puerts运行时 以及项目中的 TS 并自动接好相关入口不出意外终端会输出浏览器预览地址，直接访问即可预览效果如果 puer.config.js 中的 minigameOutputDir 配置项与 微信小游戏转换工具 导出目录不一致则需要根据提示自行手动接入


建议：微信小程序、小游戏技术生态都是基于Web之上的，所以要先保证浏览器上可正常运行，之后再打开小游戏工程来预览调试
参与开发


参与改进本工具或二次开发本请阅读 Developer Guide。
补充说明


  • 建议使用 PuerTS_Nodejs 运行时，因为可以直接使用 Node 现成的模块

    • 注意：引入 node_modules、node 自带模块，请使用 require 方法引入
        PuerTS目前未实现完整 import 支持，import 目前只支持本地模块项目要兼容 Web、微信小游戏，使用 Node 模块需要自行处理好兼容

    着色器对 WebGL 做兼容支持不建议直接使用引擎自带资源，例如：Shader.Find("Particles/Standard Unlit")引入相对模块请以 ./、../ 开头，否则编译器可能无法找到模块
项目发起者


Tencent @zombieyang、4399 Game @sbfkcel
相关项目及资料

    Puertspuerts_unity_demopuerts_unity_webgl_demominigame-unity-webgl-transform微信小游戏开发者文档-快速上手Unity WebGL 微信小游戏适配
回复

使用道具 举报

返回列表 发新帖
懒得打字嘛，点击右侧快捷回复 【右侧内容，后台自定义】
高级模式
B Color Image Link Quote Code Smilies
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

小黑屋|手机版|Unity开发者联盟 ( 粤ICP备20003399号 )

GMT+8, 2024-11-15 22:54 , Processed in 0.087218 second(s), 25 queries .

Powered by Discuz! X3.5 Licensed

© 2001-2024 Discuz! Team.

快速回复 返回顶部 返回列表