AutodeskGames / stingray-plugin

Ez a tároló egy egyszerű módja az induláshoz új plug-inek Autodesk Stingray 1.9.

talál egy minta beépülő modult, amely már be van állítva néhány alapvető tartalommal, valamint egy keretet, amelyre építhet:

• minta .stingray_plugin leíró fájl, amely megmondja Stingray-nek, hogy mi a plug-in és mit csinál.
• különböző összetevők, amelyek kiterjesztik a Stingray környezetet:
  • tartalmi erőforrások, amelyeket a beépülő modul elérhetővé tesz a szerkesztőben megnyitott összes Stingray projekt számára.
  • C/C++ kód, amely új funkciókkal bővíti a futásidejű motort.
  • C/C++ kód, amely kiterjeszti a szerkesztő JavaScript környezetét horgokkal a natív kódban megvalósított funkciókra.
  • JavaScript modulok, amelyek kiterjesztik a Stingray szerkesztőt új panelekkel, menükkel és parancsokkal.
  • egy Stingray tartalomprojekt, amelyet a beépülő modul felhasználói a projektkezelő sablonok lapján fognak látni.
• mindent meg kell építeni C/C++ plug-in kódot .dll fájlok készen állnak a motor és a szerkesztő betöltésére:
  • make.rb elindítja a plug-in build rendszert.
  • spm.rb build csomagok és külső könyvtárak letöltése és telepítése. Belsőleg a make.rb hívja, de önmagában is használhatja, ha a plug-innek más függőségei vannak, amelyeket automatikusan le szeretne tölteni.
  • cmake A natív bővítményekhez készít és fordít Visual Studio megoldásokat.

további információt a plug-inekről, azok működéséről és arról, hogy mit tehet velük, a Stingray SDK súgójában talál.

1.lépés. Előfeltételek telepítése

szüksége lesz egy Git kliensre, hogy klónozza a repo tartalmát a számítógépére.

Ha azt szeretné, hogy a plug-in tartalmazzon C/C++ könyvtárakat, amelyek kiterjesztik a szerkesztőt vagy a motort, akkor a következőkre is szüksége lesz:

• Ruby 2.0 vagy újabb.

• csomópont 6.11.2 LTS vagy újabb.

• Visual Studio 2015 A 3.frissítéssel& Kb3165756 javítás.

2.lépés. Szerezzen be egy helyi példányt a forrásról

be kell szereznie a repo tartalmát a számítógépére, hogy vele dolgozhasson.

fontos: meg kell szereznie ennek a repónak a verzióját, amely megfelel a Stingray verziójának, amellyel a beépülő modult használni fogja! Ez különösen igaz, ha a plug-in fogja használni a C/C++ .dll kiterjeszteni a motor vagy szerkesztő, mivel akkor kell kompatibilis változatai a Stingray SDK fejléc fájlokat lefordítani a plug-in ellen.

• amaster ág mindig szinkronban van a Stingray legújabb verziójával. Ez az alapértelmezett ág, amelyet akkor kap, ha klónozza ezt a repót. Használja, ha azt szeretné, hogy a plug-in működjön a Stingray jelenlegi verziójával.

• Ha azt szeretnénk, hogy hozzanak létre a plug-in dolgozni egy korábbi változata Stingray, akkor kap egy változata a repo, hogy megfeleljen megnézni egy release tag, vagy letölti a forrás a kiadások lap GitHub.

ha hozzáfér a Stingray forráskódjához:

• Ha a Stingray engine repo develop ágát használja a legújabb és legnagyobb változások és hibajavítások felvételéhez, használja a develop ágát a plug-in felépítéséhez.

• Ha azt szeretné, hogy a plug-in támogassa a közelgő kiadás, amely még nem nyilvánosan elérhető, de hogy saját releaseág a Stingray engine repository, használja a megfelelő release ága ezt repo szinkronban tartani.

3.lépés. Állítsa be a könyvtár könyvtárát

a beépülő modul forráskódjának minden felülvizsgálata a Git-ben nem tárolt könyvtáraktól és függőségektől függ. Ehelyett a build tools másolja ezeket a könyvtárakat a számítógépére egy internetes tárolási helyről.

a build futtatása előtt meg kell adnia egy helyet a számítógépen, ahol a build tárolja és hozzáférhet ezekhez a könyvtárakhoz.

• hozzon létre egySR_LIB_DIRnevű környezeti változót. Állítsa be az értékét a számítógép bármely üres könyvtárába, ahová a könyvtárakat másolni szeretné.

4. lépés. Build

Ha a motorhoz vagy a szerkesztőhöz C/C++ beépülő modult is tartalmaz, akkor a make.rb parancsfájl futtatásával készítse el a tároló gyökérkönyvtárában.

> ruby make.rb

Ez a parancs:

• automatikusan frissíti a könyvtár könyvtárát a buildhez szükséges összes könyvtár megfelelő verzióival.
• létrehoz és épít Visual Studio megoldások a Stingray motor és szerkesztő eszközök.

A

• számos paramétert kínál, amelyek segítségével szabályozhatja, hogy mi és hogyan épül fel. Hívja a --help parancssori paraméterrel, hogy megkapja az összes elérhető paraméter listáját.

MEGJEGYZÉS: Ha hibaüzenetet kap a tanúsítvány ellenőrzésével kapcsolatban, akkor lehet, hogy telepítenie kell ezt az SSL javítást a RubyGems számára

Build eredmények

alapértelmezés szerint a szkript az összes lefordított fájlt írja .dll fájlokat aplugin/binaries könyvtárba a gyökérkönyvtár alatt, amelyben a Stingray forráskódot klónozta.

a build/engineés build/editor mappákban létrehozott Visual Studio megoldásokat is használhatja a forráskód kezeléséhez és a könyvtárak újjáépítéséhez.

bemutató!

lásd a wiki egy tutorial, hogy végigvezeti Önt lépésről-lépésre a folyamat, hogy egy plug-in, amely kiterjeszti mind a motor és a szerkesztő.

könyvtárszerkezet

• build: különböző build kimenetek (azaz CMake generált megoldások)
• cmake: CMake helper scripts downloaded by spm
• editor: egy mappa, ahol C/C++ kódot helyezhet el, amely kiterjeszti a szerkesztőt.
• engine: egy mappa, ahol C/C++ kódot helyezhet el, amely kiterjeszti a futásidejű motort.
• plugin: Egyéb plugin források (plugin leíró, szerkesztő kiterjesztés, lefordított szerkesztő és motor extenions, stb.)
• stingray_sdk: Stingray szerkesztő és motor C/C++ fejléc alapú plugin SDK letöltve spm.
• tools: A spmáltal letöltött különféle építő eszközök.
• make.rb: interfész szkript készítése. Execute make.rb --help az összes opció megtekintéséhez.

a Stingray plugin sikeres felépítése után a plugin mappa zip-jével terjesztheti a plugint. Ha segítségre van szüksége a Stingray SDK használatának megkezdéséhez, tekintse meg a Stingray SDK fő súgójában található oktatóvideókat és témákat.

Plugin struktúra

• stingray-example.plugin: kezdeti plugin leíró. Erősen ajánlott átnevezni a fájl nevét.
• sample_project/: példa projekt, amely bemutatja, hogyan működik a plugin.

további segítség

kérjük, olvassa el a Stingray SDK súgóját további részletekért a plug-inekkel, API referencia dokumentációval és így tovább.

maradjon kapcsolatban!

az Ön visszajelzése elengedhetetlen ahhoz, hogy ez a termék sikeres legyen. Kérjük, segítsen nekünk azáltal, hogy megosztja véleményét minden olyan dologról, amit rosszul csinálunk a Stingray felhasználói fórumon vagy az Autodesk béta portál felhasználói fórumain. Az Autodesk mérnökei és tervezői aktívan részt vesznek a fórum szálaiban, így hangosan és tisztán hallhatja a hangját, és segítséget kaphat közvetlenül a forrásból.