Turbulenz SDK 安装指南：Windows / macOS / Linux 开发环境搭建、验证与示例运行

游戏开发图形学【免费下载链接】turbulenz_engineTurbulenz is a modular 3D and 2D game framework for making HTML5 powered games for browsers, desktops and mobile devices.项目地址https://gitcode.com/gh_mirrors/tu/turbulenz_engine点击查看免费下载本篇指南以官方安装文档docs/source/installing.rst为主线系统讲解 Turbulenz SDK 在 Windows、macOS、Linux 三大平台上的前置条件、安装步骤、开发环境激活、本地服务器启动、安装验证与示例运行全流程并结合开源仓库的 README.rst、manage.py 等源码资源补充以 Git 方式从源码搭建开发环境的完整途径。读完本文你将掌握从零开始安装 Turbulenz SDK、快速启动开发环境并通过内置示例验证安装是否成功的方法。Turbulenz SDK 包含什么Turbulenz SDK 是开始使用 Turbulenz 引擎的完整工具包包含以下四类内容库Libraries引擎核心 JavaScript/TypeScript 库位于仓库 tslib 目录涵盖 GraphicsDevice、SoundDevice、NetworkDevice、InputDevice、PhysicsDevice 等底层模块以及 draw2d.ts、scene.ts 等高层模块工具Tools用于处理代码与资源的命令行工具例如dae2jsonCollada 转 JSON、cgfx2jsonCgFX 着色器转 JSON、makehtml、maketzjs等文档Documentation本仓库 docs 下的全部手册与 API 参考示例Examplessamples 目录下覆盖 2D/3D 渲染、物理、粒子、声音、服务接口等主题的示例以及 apps 目录下的完整应用如 multiworm、tictactoe。SDK 中同时包含 Turbulenz Engine 开源仓库的全部内容含预构建示例以及面向不支持 WebGL 等新特性浏览器/平台的Turbulenz Engine Installer浏览器插件。也就是说开发者既可以通过官方 SDK 安装包获得开箱即用的环境也可以直接基于 README.rst 从 Git 仓库自行搭建。技术支持渠道遇到问题时可参考以下路径登录 Turbulenz Hub官方下载站点击落地页的Support按钮即可自动进入支持服务查阅知识库knowledge base或创建支持请求support request使用支持站点的更多帮助参见仓库中的 支持文档。官方文档始终可通过在线地址访问且支持站点与 SDK 版本保持同步。安装前的系统要求在开始安装之前需要先确认机器满足以下前置条件。无论哪个平台最核心的一条是Turbulenz 工具链仅支持 Python 2.7.3 及以上版本2.7.x 系列不能使用 Python 3.X。这是仓库源码中硬性校验的约束——manage.py 中command_env的第一条检查就是if sys.version_info[1] ! 7: error(Turbulenz requires python 2.7) return -1各平台的具体前置依赖如下。WindowsXP / Vista / 7必需EssentialPython 2.7.3官方下载站。开源仓库 README.rst 进一步建议Windows 上推荐安装32 位Python若机器上同时装有多个 Python 版本例如 3.x可能需要用python2.7命令显式调用若安装时未将 Python 加入 PATH则需使用完整路径C:\Python27\python.exe。推荐RecommendedMicrosoft Visual Studio 2008用于在平台允许时为 Python 环境编译加速模块speed-ups。强烈建议在安装 Turbulenz SDK 之前先装好 VS这样 speed-ups 才能在环境中正确配置PDF 阅读器用于阅读 PDF 格式的文档。⚠️ 注意如果使用的是 64 位版本的 Python则必须安装 64 位版本的 Visual Studio 编译器否则无法编译加速模块。macOSOS X 10.7 及以上必需EssentialPython 2.7.3Cg ToolkitNVIDIA 官方提供cgfx2json工具依赖该库来编译着色器Xcode Command Line Tools2012 年 2 月或更新版本如果尚未安装完整 Xcode仅安装命令行工具即可下载体积远小于完整 Xcode如果已安装 Xcode可在 Xcode 的 Downloads 偏好设置 → components 标签页中选择安装 Command Line Tools。LinuxBETALinux 版本 SDK 以自解压 shell 脚本形式发布已针对 Ubuntu 12.0464 位完成测试同时也欢迎其他较新发行版的使用反馈。需要特别注意的是⚠️Linux 版浏览器插件尚未发布因此 Linux 上运行游戏时必须使用 canvas 模式即仅依赖浏览器内置的 WebGL 能力。从源码角度看starter/getting_started_guide.rst 也明确提示在 Linux 上构建应用时使用makehtml --mode canvas-debug即可在 Linux 浏览器中运行。Linux 平台建议通过包管理器安装以下依赖必需EssentialPython 2.7.3含开发文件Linux 下必须安装 Python 开发包库与头文件。Ubuntu 上执行sudo apt-get install python-dev同时建议从发行版包管理器安装virtualenv与setuptoolssudo apt-get install python-virtualenv python-setuptoolsGCC含 g必须在运行安装脚本之前安装以便 Python 能够编译某些模块Cg Toolkit 3.0SDK 中的cgfx2json工具依赖该库。可以从包管理器安装也可以前往 NVIDIA 官网下载最新版本并确保选择与系统匹配的 32/64 位配置。开源仓库 README.rst 还补充了构建本地工具cgfx2json、NvTriStrip时的额外依赖Linux 需要 GCC 4.6.x 或更高版本以及 OpenGL 开发库Debian 系发行版安装libgl1-mesa-dev例如sudo apt-get install libgl1-mesa-devmacOS 需要 Xcode 命令行工具Windows 可使用 VS2008 SP1、VS2010、VC 2010 Express 或 VS2012含 update 2等任意一种。分平台安装步骤以下安装步骤中X.X.X为 SDK 版本号占位符请替换为实际下载的版本号。Windows 安装访问官方 Hub 并登录下载 Windows 版 SDKTurbulenzSDK-X.X.X.exe运行TurbulenzSDK-X.X.X.exe按安装向导提示完成安装。Windows 版 SDK 为自解压安装程序self-extracting installer exe包含开发 Turbulenz 应用所需的工具、示例和引擎组件。macOS 安装访问官方 Hub 并登录下载 Mac 版 SDK在与 SDK 安装包相同的目录打开终端依次执行chmod ax TurbulenzSDK-X.X.X.run ./TurbulenzSDK-X.X.X.run按安装向导提示完成安装。Mac 版 SDK 以自解压 shell 脚本beta形式提供同样包含工具、示例和引擎组件。Linux 安装访问官方 Hub 并登录下载 Linux 版 SDK在与 SDK 安装包相同的目录打开终端依次执行chmod ax TurbulenzSDK-X.X.X.linux.run ./TurbulenzSDK-X.X.X.linux.run按安装向导提示完成安装。从开源仓库搭建替代方案如果不使用官方 SDK 安装包而是希望直接基于开源代码工作例如跟进最新版本或参与贡献README.rst 给出了完整流程# 1. 克隆仓库 $ git clone git://github.com/turbulenz/turbulenz_engine.git # 2. 初始化 Git 子模块external 目录下的 tzbuild、DefinitelyTyped、UglifyJS、NvTriStrip $ git submodule update --init # 3. 确认已满足前置条件Python 2.7.x、virtualenv 1.9.1 等 # 4. 创建虚拟环境自动安装所需 Python 包与 NodeJS $ python manage.py env # 5. 激活环境bash 使用 sourceWindows 使用 activate.bat $ source env/bin/activate # bash 等类 Unix shell env\scripts\activate.bat # Windows # 6. 由 TypeScript 源码构建 JavaScript 库 $ python manage.py jslibmanage.py 中command_env的实现显示环境创建会通过virtualenv建立env目录路径常量ENV env定义于 scripts/utils.py并自动easy_install安装simplejson、PyYAML、pylint、roman、docutils、Sphinx、turbulenz_tools、turbulenz_local等依赖包随后通过 scripts/install_nodejs.py 安装 NodeJS含 TypeScript 支持并全局安装tslint。这正好解释了官方文档中SDK 使用 Python 虚拟环境、避免污染系统默认 Python 目录的设计初衷。仓库方式下还可通过manage.py执行更多操作python manage.py tools编译 cgfx2json 等本地工具、python manage.py docs构建 HTML 文档、python manage.py samples构建示例、python manage.py apps构建 apps 目录下的应用。运行 SDK激活开发环境SDK 安装完成后需要通过Run the Environment进入虚拟环境来运行配套工具。Windows通过开始菜单快捷方式进入 SDK 虚拟环境命令行开始菜单 - 程序 - Turbulenz - SDK X.X.X - Run Environment X.X.X说明该环境启动后的起始目录是 SDK 的安装目录。macOS / Linux在终端中执行cd *SDKINSTALLDIR* source start_env激活成功后命令提示符前会出现(env)标签此时即可运行 SDK 提供的各种命令行工具。运行 SDK启动本地开发服务器本地开发服务器Local Development Server用于在本地机器或局域网内测试你的游戏同时具备文件服务、Turbulenz 在线服务模拟、指标记录、项目部署等能力详见 本地服务器用户指南。Windows通过开始菜单中的对应快捷方式启动。macOS / Linux在终端中执行*SDKINSTALLDIR*/start_local.sh⚠️防火墙提示首次运行本地服务器时部分防火墙可能会弹出提示询问是否允许python或python.exe监听端口。必须授予权限服务器才能正常启动运行。验证安装是否成功Turbulenz 工具基于 Python 虚拟环境运行其中安装了全部必需的 Python 包从而避免了向系统默认 Python 目录安装包。安装完成后建议按以下三步验证启动本地服务器操作方式见上一节确保没有任何报错。Windows 上应看到浏览器自动打开并显示开发服务器首页运行 Turbulenz 环境操作方式见上文。命令行提示符前出现(env)前缀即表示环境激活成功在环境命令行中测试工具输入dae2json应显示dae2json命令的命令行选项说明如果看到的是错误信息说明环境没有正确安装。dae2json是 SDK 中最常用的资源工具之一负责将 Collada.dae模型转换为 Turbulenz 引擎的 JSON 资源格式。根据 工具文档其语法为dae2json [options] -i source.dae -o target.json典型用法示例dae2json -v -m -i assets/models/duck.dae -o apps/sampleapp/models/duck.dae.json该工具基于 Collada 规范实现引擎使用Y-up坐标系约定SDK 0.25.0 起新增--nvtristrip选项可通过 NvTriStripper 启用顶点缓存优化。仓库 assets/models 下的duck.dae、Seymour.dae、sphere.dae等模型资源均可用于测试该工具。运行示例验证全流程本地开发服务器运行后即可通过浏览器体验内置示例打开浏览器访问http://127.0.0.1:8070点击Samples项目再点击Play按钮显示可用示例列表每个示例对应多个 HTML 文件分别代表不同的构建配置如 canvas-debug、canvas release 等点击某个 HTML 文件名即可打开并运行对应示例。关于构建配置starter/getting_started_guide.rst 解释了三种主要模式plugin使用浏览器扩展插件提供底层能力代码打包为单个.tzjs文件适合发布部署canvas不使用插件仅依赖浏览器内置能力代码打包为单个.js文件canvas-debug面向开发调试代码几乎不做转换可直接用浏览器开发者工具调试也是 Linux 平台唯一可用的运行模式。示例源码位于 samples/tsscripts/templates例如 2D 渲染的 draw2d.ts、3D 渲染的 camera.ts、物理的 physics.ts 等它们由 TypeScript 编写构建后生成对应的 HTML 页面。平台与浏览器支持情况需要特别注意的是官方安装文档中运行 SDK一节引用了系统要求章节对应 支持的平台与浏览器文档。对最终玩家而言支持的平台组合为Windows32/64 位XP / Vista / 7 / 8IE 8/9/10、Firefox 3.6、ChromemacOS 10.7Safari 6、Firefox、ChromeLinux仅 WebGL 支持Firefox、ChromeAndroidChrome Beta、Firefox Beta。对开发者而言除上述组合外还提供面向 Android 与 iOS 的 Turbulenz Developer Client详情参见 developer_client_readme.rst。这些信息可用于判断目标机器与浏览器是否符合运行 SDK 及所开发游戏的软硬件要求。安装后的下一步安装与验证完成后官方推荐继续阅读 入门指南Getting Started Guide它从最简单的清屏示例出发逐步讲解如何编写、构建并运行第一个 Turbulenz 应用包括makehtml、maketzjs的完整用法并介绍 Turbulenz 应用的基本概念入口点TurbulenzEngine.onload、主循环TurbulenzEngine.setInterval、构建模式等。遇到问题时可参照 支持文档 中的文档、讨论组与开源贡献渠道发行说明则位于 release_notes可据此了解各 SDK 版本间的变更与升级信息。赞分享游戏开发图形学【免费下载链接】turbulenz_engineTurbulenz is a modular 3D and 2D game framework for making HTML5 powered games for browsers, desktops and mobile devices.项目地址https://gitcode.com/gh_mirrors/tu/turbulenz_engine点击查看免费下载相关推荐Compartment离线保障运行时防护如何阻止网络连接确保数据安全Compartment离线保障运行时防护如何阻止网络连接确保数据安全 在当今数字化时代数据安全已成为个人和企业最关心的问题之一。Compartment作为一音视频图形学桌面应用PaddleOCR 运行环境准备完全指南Windows、macOS 与 LinuxAnaconda / Docker环境搭建PaddleOCR 运行环境准备完全指南Windows、macOS 与 LinuxAnaconda / Docker环境搭建 本篇技术指南以 docs/v人工智能计算机视觉OCR深度学习大模型RAGTensorFlow pip 安装完整指南Linux / macOS / Windows含 WSL2GPU 与 CPU 环境搭建、验证与排错TensorFlow pip 安装完整指南Linux / macOS / Windows含 WSL2GPU 与 CPU 环境搭建、验证与排错 本文面向 T文档开发工具教程上一篇Nacos Console 域规范部署模式、端口模型与 Handler/Proxy 分层解析下一篇freeCodeCamp 每日编码挑战解析Python 实现Jbelmud Text字符串字母重排问题创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考