Dora 启动！

一、安装

• Android

  • 1、在游戏的运行终端下载并安装APK包。
  • 2、运行软件，通过局域网内的PC（平板或其他开发设备）的浏览器访问软件显示的服务器地址。
  • 3、开始游戏开发。

• Windows、macOS

  • 1、下载并运行软件。
    • 在macOS上也可以通过Homebrew进行软件安装。

      brew tap ippclub/dora-ssr
      brew install --cask dora-ssr
  • 2、通过浏览器访问软件显示的服务器地址。
  • 3、开始游戏开发。

• Linux

  • 1、安装软件：
    • Ubuntu Jammy

    sudo add-apt-repository ppa:ippclub/dora-ssr
    sudo apt update
    sudo apt install dora-ssr
    • Debian Bookworm

    sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 9C7705BF
    sudo add-apt-repository -S "deb https://ppa.launchpadcontent.net/ippclub/dora-ssr/ubuntu jammy main"
    sudo apt update
    sudo apt install dora-ssr
  • 2、运行软件，通过浏览器访问软件显示的服务器地址。
  • 3、开始游戏开发。

二、编写游戏

1. 第一步：创建一个新项目

   • 在浏览器中，打开Dora Dora编辑器左侧游戏资源树的右键菜单。
   • 点击菜单项新建，选择新建文件夹，命名为Hello。

2. 第二步：编写游戏代码

   • 在项目文件夹下新建游戏入口代码文件，选择Yuescript语言（或Teal、Lua、Typescript）命名为init。
   • 编写代码：

TSX

Hello/init.tsx

// @preview-file on
import {React, toNode, useRef} from 'DoraX';
import {Ease, Move, Sprite} from 'Dora';

const spriteRef = useRef<Sprite.Type>();

// 创建游戏场景树根节点
// 以及一个图片精灵作为子节点
toNode(
	<node onTapBegan={(touch) => {
		const {current: sprite} = spriteRef;
		if (sprite) {
			sprite.perform(Move(
				1, // 持续时间，单位为秒
				sprite.position, // 开始位置
				touch.location, // 结束位置
				Ease.OutBack // 缓动函数
			));
		}
	}}>
		<sprite ref={spriteRef} file='Image/logo.png'/>
	</node>
);

Yuescript

Hello/init.yue

-- 导入功能模块
_ENV = Dora

-- 创建图片精灵
sprite = Sprite "Image/logo.png"

-- 创建游戏场景树根节点
with Node!

	-- 挂载图片精灵到游戏场景树根节点
	\addChild sprite

	-- 接收并处理点击事件移动图片精灵
	.touchEnabled = true
	\slot "TapBegan", (touch)->
		sprite\perform Move(
			1 -- 持续时间，单位为秒
			sprite.position -- 开始位置
			touch.location -- 结束位置
			Ease.OutBack -- 缓动函数
		)

Lua

Hello/init.lua

-- 导入功能模块
local Sprite <const> = require("Sprite")
local Node <const> = require("Node")
local Move <const> = require("Move")
local Ease <const> = require("Ease")

-- 创建图片精灵
local sprite = Sprite("Image/logo.png")

-- 创建游戏场景树根节点
local root = Node()

-- 挂载图片精灵到游戏场景树根节点
root:addChild(sprite)

-- 接收并处理点击事件移动图片精灵
root.touchEnabled = true
root:slot("TapBegan", function(touch)
	sprite:perform(Move(
		1, -- 持续时间，单位为秒
		sprite.position, -- 开始位置
		touch.location, -- 结束位置
		Ease.OutBack -- 缓动函数
	))
end)

Teal

Hello/init.tl

-- 导入功能模块
local Sprite <const> = require("Sprite")
local Node <const> = require("Node")
local Move <const> = require("Move")
local Ease <const> = require("Ease")
local type Touch = require("TouchType")

-- 创建图片精灵
local sprite = Sprite("Image/logo.png")

-- 创建游戏场景树根节点
local root = Node()

-- 挂载图片精灵到游戏场景树根节点
root:addChild(sprite)

-- 接收并处理点击事件移动图片精灵
root.touchEnabled = true
root:slot("TapBegan", function(touch: Touch)
	sprite:perform(Move(
		1, -- 持续时间，单位为秒
		sprite.position, -- 开始位置
		touch.location, -- 结束位置
		Ease.OutBack -- 缓动函数
	))
end)

Typescript

Hello/init.ts

// 导入功能模块
import {Ease, Move, Node, Slot, Sprite} from 'Dora';

// 创建图片精灵
const sprite = Sprite("Image/logo.png");

// 创建游戏场景树根节点
const root = Node();

// 挂载图片精灵到游戏场景树根节点
root.addChild(sprite);

// 接收并处理点击事件移动图片精灵
root.touchEnabled = true;
root.slot(Slot.TapBegan, touch => {
	sprite.perform(
		Move(
			1, // 持续时间，单位为秒
			sprite.position, // 开始位置
			touch.location, // 结束位置
			Ease.OutBack // 缓动函数
		)
	);
});

3. 第三步：运行游戏

  点击编辑器右下角🎮图标，然后点击菜单项运行。或者按下组合键Ctrl + r。

三、发布游戏

1. 通过编辑器左侧游戏资源树，打开刚才新建的项目文件夹的右键菜单，点击下载选项。
2. 等待浏览器弹出已打包项目文件的下载提示。