opentiny · hexqi · Oct 29, 2025 · Sep 29, 2025 · Sep 29, 2025 · Sep 29, 2025
diff --git a/designer-demo/package.json b/designer-demo/package.json
@@ -13,6 +13,7 @@
   "dependencies": {
     "@opentiny/tiny-engine": "workspace:^",
     "@opentiny/tiny-engine-meta-register": "workspace:^",
+    "@opentiny/tiny-engine-runtime-renderer": "workspace:*",
     "@opentiny/tiny-engine-utils": "workspace:*",
     "@opentiny/vue": "~3.20.0",
     "@opentiny/vue-design-smb": "~3.20.0",

diff --git a/designer-demo/public/opentiny-tinyengine-logo.svg b/designer-demo/public/opentiny-tinyengine-logo.svg
diff --git a/designer-demo/runtime.html b/designer-demo/runtime.html
@@ -0,0 +1,13 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" href="/opentiny-tinyengine-logo.svg" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Runtime Render</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/runtime.js"></script>
+  </body>
+</html>
diff --git a/designer-demo/src/runtime.js b/designer-demo/src/runtime.js
@@ -0,0 +1,24 @@
+/**
+ * Copyright (c) 2023 - present TinyEngine Authors.
+ * Copyright (c) 2023 - present Huawei Cloud Computing Technologies Co., Ltd.
+ *
+ * Use of this source code is governed by an MIT-style license.
+ *
+ * THE OPEN SOURCE SOFTWARE IN THIS PRODUCT IS DISTRIBUTED IN THE HOPE THAT IT WILL BE USEFUL,
+ * BUT WITHOUT ANY WARRANTY, WITHOUT EVEN THE IMPLIED WARRANTY OF MERCHANTABILITY OR FITNESS FOR
+ * A PARTICULAR PURPOSE. SEE THE APPLICABLE LICENSES FOR MORE DETAILS.
+ *
+ */
+import { initRuntimeRenderer } from '@opentiny/tiny-engine-runtime-renderer'
+
+async function startApp() {
+  try { 
+    await initRuntimeRenderer()
+  }
+  catch (error) { 
+    //eslint-disable-next-line no-console
+    console.error('Failed to initialize runtime renderer:',error)
+  }
+}
+
+startApp()
diff --git a/packages/build/vite-config/src/default-config.js b/packages/build/vite-config/src/default-config.js
@@ -109,7 +109,8 @@ const getDefaultConfig = (engineConfig) => {
         plugins: [nodePolyfill({ include: null })], // 使用@rollup/plugin-inject的默认值{include: null}, 即在所有代码中生效
         input: {
           index: path.resolve(process.cwd(), './index.html'),
-          preview: path.resolve(process.cwd(), './preview.html')
+          preview: path.resolve(process.cwd(), './preview.html'),
+          runtime: path.resolve(process.cwd(), './runtime.html')
         },
         output: {
           manualChunks: (id) => {

diff --git a/packages/build/vite-config/src/vite-plugins/devAliasPlugin.js b/packages/build/vite-config/src/vite-plugins/devAliasPlugin.js
@@ -41,11 +41,13 @@ const getDevAlias = (useSourceAlias) => {
     '@opentiny/tiny-engine-toolbar-logo': path.resolve(basePath, 'packages/toolbars/logo/index.ts'),
     '@opentiny/tiny-engine-toolbar-media': path.resolve(basePath, 'packages/toolbars/media/index.ts'),
     '@opentiny/tiny-engine-toolbar-preview': path.resolve(basePath, 'packages/toolbars/preview/index.ts'),
+    '@opentiny/tiny-engine-runtime-renderer': path.resolve(basePath, 'packages/runtime-renderer/index.ts'),
     '@opentiny/tiny-engine-toolbar-generate-code': path.resolve(basePath, 'packages/toolbars/generate-code/index.ts'),
     '@opentiny/tiny-engine-toolbar-refresh': path.resolve(basePath, 'packages/toolbars/refresh/index.ts'),
     '@opentiny/tiny-engine-toolbar-redoundo': path.resolve(basePath, 'packages/toolbars/redoundo/index.ts'),
     '@opentiny/tiny-engine-toolbar-clean': path.resolve(basePath, 'packages/toolbars/clean/index.ts'),
     '@opentiny/tiny-engine-toolbar-theme-switch': path.resolve(basePath, 'packages/toolbars/themeSwitch/index.ts'),
+    '@opentiny/tiny-engine-toolbar-runtime-deploy': path.resolve(basePath, 'packages/toolbars/runtime-deploy/index.ts'),
     '@opentiny/tiny-engine-toolbar-save': path.resolve(basePath, 'packages/toolbars/save/index.ts'),
     '@opentiny/tiny-engine-toolbar-setting': path.resolve(basePath, 'packages/toolbars/setting/index.ts'),
     '@opentiny/tiny-engine-toolbar-collaboration': path.resolve(basePath, 'packages/toolbars/collaboration/index.ts'),

diff --git a/packages/common/js/runtime-deploy.js b/packages/common/js/runtime-deploy.js
@@ -0,0 +1,85 @@
+/**
+ * Copyright (c) 2023 - present TinyEngine Authors.
+ * Copyright (c) 2023 - present Huawei Cloud Computing Technologies Co., Ltd.
+ *
+ * Use of this source code is governed by an MIT-style license.
+ *
+ * THE OPEN SOURCE SOFTWARE IN THIS PRODUCT IS DISTRIBUTED IN THE HOPE THAT IT WILL BE USEFUL,
+ * BUT WITHOUT ANY WARRANTY, WITHOUT EVEN THE IMPLIED WARRANTY OF MERCHANTABILITY OR FITNESS FOR
+ * A PARTICULAR PURPOSE. SEE THE APPLICABLE LICENSES FOR MORE DETAILS.
+ *
+ */
+
+import { getMergeMeta, useNotify, usePage } from '@opentiny/tiny-engine-meta-register'
+import { isDevelopEnv } from './environments'
+
+let runtimeWindow = null
+
+const getRuntimeLocation = async () => {
+  const paramsMap = new URLSearchParams(location.search)
+  const tenant = paramsMap.get('tenant') || ''
+  const platform = getMergeMeta('engine.config')?.platformId
+  const appId = paramsMap.get('id')
+  const queryPageId = paramsMap.get('pageId') || paramsMap.get('pageid') || ''
+
+  const { pageSettingState, getAncestors } = usePage()
+
+  const activePageId = queryPageId
+  let routeSegment = ''
+  if (activePageId) {
+    const chain = ((await getAncestors(String(activePageId), true)) || [])
+      .concat(String(activePageId))
+      .map((id) => String(id))
+    routeSegment = chain
+      .map((id) => pageSettingState.treeDataMapping[id]?.route || '')
+      .filter(Boolean)
+      .map((segment) => segment.replace(/^\/+|\/+$/g, ''))
+      .join('/')
+  }
+
+  const params = new URLSearchParams()
+  if (appId) params.set('id', appId)
+  if (tenant) params.set('tenant', tenant)
+  if (platform) params.set('platform', platform)
+
+  return {
+    query: params.toString(),
+    hash: routeSegment ? `#/${routeSegment}` : ''
+  }
+}
+
+export const deployPage = async () => {
+  const href = window.location.href.split('?')[0] || './'
+  const { query, hash } = await getRuntimeLocation()
+
+  const customDeployUrl = getMergeMeta('engine.toolbars.runtimeDeploy')?.options?.deployUrl
+  const defaultDeployUrl = isDevelopEnv ? `./runtime.html` : `${href.endsWith('/') ? href : `${href}/`}runtime`
+  const querySuffix = query ? `?${query}` : ''
+
+  const appendHash = (url) => {
+    if (!hash) return url
+    return url.includes('#') ? url : `${url}${hash}`
+  }
+
+  const buildUrl = (base) => appendHash(`${base}${querySuffix}`)
+
+  let openUrl = ''
+  openUrl = customDeployUrl
+    ? typeof customDeployUrl === 'function'
+      ? appendHash(String(customDeployUrl(defaultDeployUrl, query, hash) || defaultDeployUrl))
+      : buildUrl(customDeployUrl)
+    : buildUrl(defaultDeployUrl)
+  return { openUrl }
+}
+export const runtimeDeploy = async () => {
+  const { openUrl } = await deployPage()
+
+  runtimeWindow = window.open(openUrl, 'tiny-engine-runtime')
+  if (!runtimeWindow) {
+    useNotify({
+      type: 'error',
+      title: '运行时窗口打开失败',
+      message: '请检查浏览器是否允许新窗口打开'
+    })
+  }
+}
diff --git a/packages/design-core/package.json b/packages/design-core/package.json
@@ -78,12 +78,14 @@
     "@opentiny/tiny-engine-toolbar-logo": "workspace:*",
     "@opentiny/tiny-engine-toolbar-media": "workspace:*",
     "@opentiny/tiny-engine-toolbar-preview": "workspace:*",
+    "@opentiny/tiny-engine-toolbar-runtime-deploy": "workspace:*",
     "@opentiny/tiny-engine-toolbar-redoundo": "workspace:*",
     "@opentiny/tiny-engine-toolbar-refresh": "workspace:*",
     "@opentiny/tiny-engine-toolbar-save": "workspace:*",
     "@opentiny/tiny-engine-toolbar-setting": "workspace:*",
     "@opentiny/tiny-engine-toolbar-theme-switch": "workspace:*",
     "@opentiny/tiny-engine-toolbar-view-setting": "workspace:*",
+    "@opentiny/tiny-engine-runtime-renderer": "workspace:*",
     "@opentiny/tiny-engine-utils": "workspace:*",
     "@opentiny/tiny-engine-vite-plugin-meta-comments": "workspace:*",
     "@vue/babel-plugin-jsx": "^1.2.5",

diff --git a/packages/design-core/re-export.js b/packages/design-core/re-export.js
@@ -11,6 +11,7 @@ export { default as Save } from '@opentiny/tiny-engine-toolbar-save'
 export { default as Clean } from '@opentiny/tiny-engine-toolbar-clean'
 export { default as ThemeSwitch, ThemeSwitchService } from '@opentiny/tiny-engine-toolbar-theme-switch'
 export { default as Preview } from '@opentiny/tiny-engine-toolbar-preview'
+export { default as RuntimeDeploy } from '@opentiny/tiny-engine-toolbar-runtime-deploy'
 export { default as GenerateCode, SaveLocalService } from '@opentiny/tiny-engine-toolbar-generate-code'
 export { default as Refresh } from '@opentiny/tiny-engine-toolbar-refresh'
 export { default as Collaboration } from '@opentiny/tiny-engine-toolbar-collaboration'

diff --git a/packages/design-core/registry.js b/packages/design-core/registry.js
@@ -25,6 +25,7 @@ import {
   Clean,
   ThemeSwitch,
   Preview,
+  RuntimeDeploy,
   GenerateCode,
   Refresh,
   Collaboration,
@@ -140,6 +141,7 @@ export default {
     __TINY_ENGINE_REMOVED_REGISTRY['engine.toolbars.collaboration'] === false ? null : Collaboration,
     __TINY_ENGINE_REMOVED_REGISTRY['engine.toolbars.clean'] === false ? null : Clean,
     __TINY_ENGINE_REMOVED_REGISTRY['engine.toolbars.preview'] === false ? null : Preview,
+    __TINY_ENGINE_REMOVED_REGISTRY['engine.toolbars.runtime-deploy'] === false ? null : RuntimeDeploy,
     __TINY_ENGINE_REMOVED_REGISTRY['engine.toolbars.refresh'] === false ? null : Refresh,
     __TINY_ENGINE_REMOVED_REGISTRY['engine.toolbars.generate-code'] === false ? null : GenerateCode,
     __TINY_ENGINE_REMOVED_REGISTRY['engine.toolbars.save'] === false ? null : Save,

diff --git a/packages/layout/src/defaultLayout.js b/packages/layout/src/defaultLayout.js
@@ -26,6 +26,7 @@ export default {
     right: [
       [META_APP.ThemeSwitch, META_APP.RedoUndo, META_APP.Clean],
       [META_APP.Preview],
+      [META_APP.RuntimeDeploy],
       [META_APP.GenerateCode, META_APP.Save]
     ],
     collapse: [

diff --git a/packages/register/src/constants.ts b/packages/register/src/constants.ts
@@ -37,6 +37,7 @@ export const META_APP = {
   Save: 'engine.toolbars.save',
   GenerateCode: 'engine.toolbars.generate-code',
   Preview: 'engine.toolbars.preview',
+  RuntimeDeploy: 'engine.toolbars.runtime-deploy',
   RedoUndo: 'engine.toolbars.redoundo',
   Fullscreen: 'engine.toolbars.fullscreen',
   Lock: 'engine.toolbars.lock',

diff --git a/packages/runtime-renderer/index.ts b/packages/runtime-renderer/index.ts
@@ -0,0 +1,55 @@
+/**
+ * Copyright (c) 2023 - present TinyEngine Authors.
+ * Copyright (c) 2023 - present Huawei Cloud Computing Technologies Co., Ltd.
+ *
+ * Use of this source code is governed by an MIT-style license.
+ *
+ * THE OPEN SOURCE SOFTWARE IN THIS PRODUCT IS DISTRIBUTED IN THE HOPE THAT IT WILL BE USEFUL,
+ * BUT WITHOUT ANY WARRANTY, WITHOUT EVEN THE IMPLIED WARRANTY OF MERCHANTABILITY OR FITNESS FOR
+ * A PARTICULAR PURPOSE. SEE THE APPLICABLE LICENSES FOR MORE DETAILS.
+ *
+ */
+
+import { createApp } from 'vue'
+import { useAppSchema } from './src/composables/useAppSchema'
+import { createAppRouter } from './src/router'
+import { createPinia } from 'pinia'
+import { createStores, generateStoresConfig } from './src/stores'
+import App from './src/App.vue'
+import i18n from '@opentiny/tiny-engine-i18n-host'
+
+// 初始化运行时渲染器
+export const initRuntimeRenderer = async () => {
+  const searchParams = new URLSearchParams(location.search)
+  const appId = searchParams.get('id')
+
+  if (!appId) {
+    throw new Error('Missing required "id" query parameter')
+  }
+
+  const { fetchAppSchema, fetchBlocks } = useAppSchema()
+  await fetchAppSchema(appId)
+  await fetchBlocks()
+  const router = await createAppRouter()
+
+  const pinia = createPinia()
+  const storesConfig = generateStoresConfig()
+  const stores = createStores(storesConfig, pinia)
+
+  const app = createApp(App)
+  app.provide('stores', stores)
+
+  // 全局错误处理（防止 scheduler 被打断）
+  app.config.errorHandler = (err, instance, info) => {
+    // eslint-disable-next-line no-console
+    console.error('[GlobalErrorHandler]', err, info)
+    if ((err as any)?.stack) {
+      // eslint-disable-next-line no-console
+      console.error('[GlobalErrorHandler stack]', (err as any).stack)
+    }
+  }
+
+  app.use(pinia).use(router).use(i18n).mount('#app')
+
+  return app
+}
diff --git a/packages/runtime-renderer/package.json b/packages/runtime-renderer/package.json
@@ -0,0 +1,42 @@
+{
+  "name": "@opentiny/tiny-engine-runtime-renderer",
+  "version": "1.0.0",
+  "description": "TinyEngine Runtime Renderer Package",
+  "type": "module",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "@opentiny/tiny-engine-builtin-component": "workspace:*",
+    "@opentiny/tiny-engine-i18n-host": "workspace:*",
+    "@vue/babel-plugin-jsx": "^1.2.5",
+    "@babel/core": "^7.18.13",
+    "@vue/shared": "^3.3.4",
+    "axios": "^1.10.0",
+    "axios-mock-adapter": "^1.19.0",
+    "pinia": "^2.1.0",
+    "vue-router": "^4.2.0",
+    "postcss": "^8.4.31",
+    "postcss-selector-parser": "^7.0.0"
+  },
+  "devDependencies": {
+    "@vitejs/plugin-vue": "^5.1.2",
+    "typescript": "^5.4.2",
+    "vite": "^5.4.2"
+  },
+  "peerDependencies": {
+    "@opentiny/vue": "^3.20.0",
+    "@opentiny/vue-icon": "^3.20.0",
+    "@opentiny/vue-locale": "~3.20.0",
+    "@opentiny/vue-theme": "~3.20.0",
+    "vue": "^3.4.15",
+    "vue-i18n": "^9.9.0"
+  }
+}
diff --git a/packages/runtime-renderer/src/App.vue b/packages/runtime-renderer/src/App.vue
@@ -0,0 +1,3 @@
+<template>
+  <router-view :key="$route.fullPath" />
+</template>