Document ResourceManager.load runtime URL and virtualPath boundary
I maintainer di solito rispondono entro 1 giorno
Nessuno ha ancora preso questa issue.
Valutazione
- Difficoltà
- 1/5
- Tempo stimato
- Meno di un'ora
- Idoneità per principianti
- 85/100
- Tipo di issue
- Documentazione
- Chiarezza
- Specificata chiaramente
- Stato di attività
- Tranquilla
- Stack tecnologico
- typescript
- Ambito
- documentation
Direzione di ricerca
Aggiorna engine-knowledge/references/resource-ownership.md con la versione e la relativa voce di routing per coprire il caricamento delle risorse in fase di esecuzione. Usa i link alle fonti nell’issue per verificare il contratto dichiarato per ResourceManager.load() e ProjectLoader nella versione 2.0.0-alpha.43. Il lavoro è completo quando il riferimento spiega gli URL del browser e i valori esatti registrati di virtualPath, esclude i percorsi del filesystem host ed è pianificato per la prossima versione di Engine.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Descrizione
Problem
The exact-version engine-knowledge Skill does not currently explain what kind of path ResourceManager.load() accepts. Downstream authoring tools can therefore confuse an editor project path or host filesystem path with a runtime load key, producing requests such as resourceManager.load("/Textures/icon.png") that become browser HTTP requests and may 404.
Source-backed contract
In 2.0.0-alpha.43:
ResourceManager.load()resolves an ordinary input throughbaseUrlor an exact registeredvirtualPath.ProjectLoaderregisters runtime virtual resources from projectdata.files.- The final request uses
XMLHttpRequest; it does not read the host filesystem.
Source:
- https://github.com/galacean/engine/blob/490d2bc8ca1f1c187a995da3c913e59c56959a30/packages/core/src/asset/ResourceManager.ts#L188-L206
- https://github.com/galacean/engine/blob/490d2bc8ca1f1c187a995da3c913e59c56959a30/packages/core/src/asset/ResourceManager.ts#L338-L349
- https://github.com/galacean/engine/blob/490d2bc8ca1f1c187a995da3c913e59c56959a30/packages/core/src/asset/request.ts#L53-L121
- https://github.com/galacean/engine/blob/490d2bc8ca1f1c187a995da3c913e59c56959a30/packages/loader/src/ProjectLoader.ts#L14-L29
Requested change
Add the following runtime semantic to the existing versioned engine-knowledge/references/resource-ownership.md, and include runtime resource loading in its routing entry:
resourceManager.load()resolves a browser URL or an exactvirtualPathalready registered withResourceManager; it never reads a host filesystem path.
No runtime API change or new Skill reference is needed. Because the Skill ships with @galacean/engine, publish the documentation with the next Engine version rather than changing an already published package.
- Lingua principale
- TypeScript
- Stelle
- 5.9k
- Fork
- 413
- Merge medio
- 16h 17m
- PR unite (30g)
- 41
Preparare l'ambiente
- Nessun Dockerfile né file Docker Compose
- Ha un modello di pull request
- Nessuna guida per i contributori
Come iniziare
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Altre issue di galacean/engine
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 64/100
I maintainer di solito rispondono entro 1 giorno
-
Difficoltà 4/5 3-5 giorni Idoneità per principianti 52/100
I maintainer di solito rispondono entro 1 giorno
-
RFC: Adopt Unity-style Collider components and hierarchical Rigidbody ownershipForse già presa Una pull request collegata a questa issue è aperta o già unita. Aperta
Difficoltà 5/5 Più di una settimana Idoneità per principianti 20/100
I maintainer di solito rispondono entro 1 giorno
-
SkinnedMeshRenderer should derive default rootBone-space localBounds from mesh and skinForse già presa Una pull request collegata a questa issue è aperta o già unita. Apertaenhancement
Difficoltà 4/5 3-5 giorni Idoneità per principianti 42/100
I maintainer di solito rispondono entro 1 giorno
-
performance
Difficoltà 5/5 Più di una settimana Idoneità per principianti 25/100
I maintainer di solito rispondono entro 1 giorno
Tutte le issue di galacean/engine
Issue simili
-
bug impact:low Team: SecuritySolution Team:Defend Workflows v9.6.0
Difficoltà 2/5 1-3 ore Idoneità per principianti 72/100
elastic/kibana#306401 · 3 commenti ·
I maintainer di solito rispondono entro 1 giorno
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 68/100
agentes-chat/agentes-chat#927 ·
I maintainer di solito rispondono entro 1 giorno
-
[Bug]: Webapp workspace fails to render in Safari — "Can't find variable: requestIdleCallback"Apertacomp/desktop P2 type/bug
Difficoltà 2/5 1-3 ore Idoneità per principianti 78/100
NousResearch/hermes-agent#157702 ·
I maintainer di solito rispondono entro 1 giorno
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 76/100
I maintainer di solito rispondono entro 1 giorno
-
e2e-failure ready-to-code
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 72/100
redhat-developer/rhdh-plugin-export-overlays#4794 · 1 commento ·
I maintainer di solito rispondono entro 1 giorno