Merge branch 'v4.0.0' into v3.8.8-lg2

Author: star-e

cc.config.json

@@ -434,6 +434,20 @@
                 "pal/wasm": "pal/wasm/wasm-minigame.ts"
             }
         },
+        {
+            "test": "context.buildTimeConstants && context.buildTimeConstants.NODEJS",
+            "isVirtualModule": true,
+            "overrides": {
+                "pal/minigame": "pal/minigame/non-minigame.ts",
+                "pal/audio": "pal/audio/nodejs/player.ts",
+                "pal/system-info": "pal/system-info/nodejs/system-info.ts",
+                "pal/screen-adapter": "pal/screen-adapter/nodejs/screen-adapter.ts",
+                "pal/input": "pal/input/nodejs/index.ts",
+                "pal/env": "pal/env/nodejs/env.ts",
+                "pal/pacer": "pal/pacer/pacer-nodejs.ts",
+                "pal/wasm": "pal/wasm/wasm-nodejs.ts"
+            }
+        },
         {
             "test": "context.buildTimeConstants && context.buildTimeConstants.NOT_PACK_PHYSX_LIBS",
             "isVirtualModule": false,
@@ -638,6 +652,13 @@
             "ccGlobal": true,
             "internal": false
         },
+        "NODEJS": {
+            "comment": "Running in the Node.js environment.",
+            "type": "boolean",
+            "value": false,
+            "ccGlobal": true,
+            "internal": false
+        },
         "EDITOR": {
             "comment": "Running in the editor.",
             "type": "boolean",

cocos/2d/assets/sprite-atlas.ts

@@ -23,7 +23,7 @@
  THE SOFTWARE.
 */
 
-import { EDITOR, TEST } from 'internal:constants';
+import { EDITOR, NODEJS, TEST } from 'internal:constants';
 import { ccclass, serializable, editable } from 'cc.decorator';
 import { Asset } from '../../asset/assets';
 import { SpriteFrame } from './sprite-frame';
@@ -112,7 +112,7 @@ export class SpriteAtlas extends Asset {
      * @deprecated since v3.5.0, this is an engine private interface that will be removed in the future.
      */
     public _serialize (ctxForExporting: any): any {
-        if (EDITOR || TEST) {
+        if (EDITOR || NODEJS || TEST) {
             const frames: string[] = [];
             for (const key in this.spriteFrames) {
                 const spriteFrame = this.spriteFrames[key];

cocos/2d/assets/sprite-frame.ts

@@ -26,7 +26,7 @@
 */
 
 import { ccclass } from 'cc.decorator';
-import { EDITOR, TEST, BUILD } from 'internal:constants';
+import { EDITOR, NODEJS, TEST, BUILD } from 'internal:constants';
 import { Rect, Size, Vec2, Vec3, Vec4, cclegacy, errorID, warnID, js, v3, mat4, rect, v4, v2, size } from '../../core';
 import { Asset } from '../../asset/assets/asset';
 import { TextureBase } from '../../asset/assets/texture-base';
@@ -649,7 +649,7 @@ export class SpriteFrame extends Asset {
     constructor (name?: string) {
         super(name);
 
-        if (EDITOR) {
+        if (EDITOR || NODEJS) {
             // Atlas asset uuid
             this._atlasUuid = '';
         }
@@ -1200,7 +1200,7 @@ export class SpriteFrame extends Asset {
      * @deprecated since v3.5.0, this is an engine private interface that will be removed in the future.
      */
     public _serialize (ctxForExporting: any): any {
-        if (EDITOR || TEST) {
+        if (EDITOR || TEST || NODEJS) {
             const rect = { x: this._rect.x, y: this._rect.y, width: this._rect.width, height: this._rect.height };
             const offset = { x: this._offset.x, y: this._offset.y };
             const originalSize = this._originalSize;
@@ -1298,7 +1298,7 @@ export class SpriteFrame extends Asset {
             }
         }
 
-        if (EDITOR) {
+        if (EDITOR || NODEJS) {
             self._atlasUuid = data.atlas ? data.atlas : '';
         }
 

cocos/animation/exotic-animation/exotic-animation.ts

@@ -22,7 +22,7 @@
  THE SOFTWARE.
 */
 
-import { EDITOR, TEST } from 'internal:constants';
+import { EDITOR, NODEJS, TEST } from 'internal:constants';
 import { binarySearchEpsilon, clamp, lerp, Quat, Vec3, _decorator } from '../../core';
 import { assertIsTrue } from '../../core/data/utils/asserts';
 import { AnimationClipGraphBindingContext } from '../marionette/animation-graph-animation-clip-binding';
@@ -31,7 +31,7 @@ import { Pose } from '../core/pose';
 import { CLASS_NAME_PREFIX_ANIM } from '../define';
 import { Binder, RuntimeBinding, TrackBinding, TrackPath } from '../tracks/track';
 
-const SPLIT_METHOD_ENABLED = TEST || EDITOR;
+const SPLIT_METHOD_ENABLED = TEST || EDITOR || NODEJS;
 
 const { ccclass, serializable } = _decorator;
 

cocos/asset/asset-manager/builtin-res-mgr.ts

@@ -22,7 +22,7 @@
  THE SOFTWARE.
 */
 
-import { EDITOR, EDITOR_NOT_IN_PREVIEW, TEST } from 'internal:constants';
+import { EDITOR, EDITOR_NOT_IN_PREVIEW, NODEJS, TEST } from 'internal:constants';
 import { Asset } from '../assets/asset';
 import { ImageAsset, ImageSource } from '../assets/image-asset';
 import { SpriteFrame } from '../../2d/assets/sprite-frame';
@@ -284,7 +284,7 @@ export class BuiltinResMgr {
             resources[spriteFrame._uuid] = spriteFrame;
         }
 
-        if (EDITOR) {
+        if (EDITOR || NODEJS) {
             const builtinAssets = settings.querySettings<string[]>(SettingsCategory.ENGINE, 'builtinAssets');
             const builtinBundle = new Bundle();
             builtinBundle.init({

cocos/asset/asset-manager/deserialize.ts

@@ -22,15 +22,15 @@
  THE SOFTWARE.
 */
 
-import { EDITOR } from 'internal:constants';
+import { EDITOR, NODEJS } from 'internal:constants';
 import { Asset } from '../assets/asset';
 import { MissingScript } from '../../misc/missing-script';
 import { deserialize, Details } from '../../serialization/deserialize';
 import { error, js } from '../../core';
 import { dependMap, nativeDependMap } from './depend-maps';
 import { decodeUuid } from './helper';
 
-const missingClass: any = EDITOR && EditorExtends.MissingReporter.classInstance;
+const missingClass: any = (EDITOR || NODEJS) && EditorExtends.MissingReporter.classInstance;
 
 export interface IDependProp {
     uuid: string;
@@ -43,7 +43,7 @@ export default function deserializeAsset (json: Record<string, any>, options: Re
     __uuid__?: string;
 }): Asset {
     let classFinder: deserialize.ClassFinder;
-    if (EDITOR) {
+    if (EDITOR || NODEJS) {
         classFinder = (type, data, owner, propName): Constructor<unknown> => {
             const res = missingClass.classFinder(type, data, owner, propName);
             if (res) {

cocos/asset/asset-manager/editor-path-replace.ts

@@ -21,16 +21,16 @@
  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
  THE SOFTWARE.
 */
-import { EDITOR, NATIVE, PREVIEW, TEST } from 'internal:constants';
-import { assert, settings, SettingsCategory } from '../../core';
+import { EDITOR, NATIVE, NODEJS, PREVIEW, TEST } from 'internal:constants';
+import { assert, settings, SettingsCategory, cclegacy } from '../../core';
 import { fetchPipeline, pipeline } from './shared';
 import Task from './task';
 
 declare const Editor: any;
-if ((EDITOR || PREVIEW) && !TEST) {
-    const cache: {[uuid: string]: string | null} = {};
+if ((EDITOR || PREVIEW || NODEJS) && !TEST) {
+    const cache: { [uuid: string]: string | null } = {};
     const resolveMap: { [uuid: string]: Function[] } = {};
-    const replaceExtension  = (task: Task, done): void => {
+    const replaceExtension = (task: Task, done): void => {
         task.output = task.input;
         (async (): Promise<void> => {
             for (let i = 0; i < task.input.length; i++) {
@@ -80,12 +80,34 @@ if ((EDITOR || PREVIEW) && !TEST) {
         try {
             let text = '';
             if (EDITOR) {
-                const info: {library: {['.bin']: any}} = await Editor.Message.request('asset-db', 'query-asset-info', uuid);
+                const info: { library: { ['.bin']: any } } = await Editor.Message.request('asset-db', 'query-asset-info', uuid);
                 // Current rule: If an asset has only one .bin file, then it is in CCON format.
                 if (info && info.library['.bin'] && Object.keys(info.library).length === 1) {
                     text = '.cconb';
                 }
-            } else {
+            } else if(NODEJS) {
+                const importBase = cclegacy.assetManager.generalImportBase;
+                let useAssetDB = true;
+                if(importBase && (importBase.startsWith('http://') || importBase.startsWith('https://'))) {
+                    // cli：场景使用的是网络路径
+                    const requestUrl = `${importBase}/query-extname/${uuid}`;
+                    try {
+                        text = await fetchText(requestUrl) as string;
+                        useAssetDB = false;
+                    } catch (e) {
+                        console.warn(`Failed to get file type from URL: ${requestUrl}. Error: ${e}`);
+                        text = '';
+                    }
+                } 
+                // 如果网络路径没有配置，或者不是网络路径，或者请求异常，使用AssetDB
+                if(useAssetDB && globalThis.AssetDB) {
+                    const meta: { files: string[] } = await globalThis.AssetDB.queryAsset(uuid)?.meta;
+                    // Current rule: If an asset has only one .bin file, then it is in CCON format.
+                    if (meta && meta.files.length === 1 && meta.files[0] === '.bin') {
+                        text = '.cconb';
+                    }
+                }
+            } else {  
                 let previewServer = '';
                 if (NATIVE) {
                     previewServer = settings.querySettings<string>(SettingsCategory.PATH, 'previewServer') || '';

cocos/asset/asset-manager/factory.ts

@@ -22,7 +22,7 @@
  THE SOFTWARE.
 */
 
-import { EDITOR } from 'internal:constants';
+import { EDITOR, NODEJS } from 'internal:constants';
 import { ImageAsset } from '../assets/image-asset';
 import JsonAsset from '../assets/json-asset';
 import { TextAsset } from '../assets/text-asset';
@@ -86,7 +86,7 @@ function createBundle (id: string, data: IConfigOption, options: Record<string,
         bundle.init(data);
     }
     //HACK: Can not import scripts in GameView due to the difference of Scripting System between the GameView and Preview
-    if (!EDITOR) {
+    if (!EDITOR && !NODEJS) {
         import(`virtual:///prerequisite-imports/${bundle.name}`).then((): void => {
             onComplete(null, bundle);
         }).catch(onComplete);

cocos/asset/asset-manager/shared.ts

@@ -22,7 +22,7 @@
  THE SOFTWARE.
 */
 
-import { EDITOR } from 'internal:constants';
+import { EDITOR, NODEJS } from 'internal:constants';
 import { Asset } from '../assets/asset';
 import Bundle from './bundle';
 import Cache from './cache';
@@ -36,7 +36,7 @@ export const bundles = new Cache<Bundle>();
 export const pipeline = new Pipeline('normal load', []);
 export const fetchPipeline = new Pipeline('fetch', []);
 export const transformPipeline = new Pipeline('transform url', []);
-export const references = EDITOR ? new Cache<any[]>() : null;
+export const references = (EDITOR || NODEJS) ? new Cache<any[]>() : null;
 export const assetsOverrideMap = new Map<string, string>();
 
 export enum RequestType {

cocos/asset/asset-manager/url-transformer.ts

@@ -22,7 +22,7 @@
  THE SOFTWARE.
 */
 
-import { EDITOR, PREVIEW } from 'internal:constants';
+import { EDITOR, NODEJS, PREVIEW } from 'internal:constants';
 import { warnID, js, path, cclegacy } from '../../core';
 import Config, { IAddressableInfo, IAssetInfo } from './config';
 import { decodeUuid } from './helper';
@@ -161,7 +161,7 @@ export function replaceOverrideAsset (task: Task): void {
         const item = input[i] as RequestItem;
         if (assetsOverrideMap.has(item.uuid)) {
             const uuid = assetsOverrideMap.get(item.uuid)!;
-            if (EDITOR || PREVIEW) {
+            if (EDITOR || PREVIEW || NODEJS) {
                 // In EDITOR, there is no bundle, so just change uuid.
                 item.overrideUuid = uuid;
                 item.ext = item.isNative ? item.ext : '.json';