NativeScript / android-runtime

Build Status

tartalmazza a NativeScript Android futásidejének forráskódját. A NativeScript egy olyan keretrendszer, amely lehetővé teszi a fejlesztők számára, hogy valóban natív mobilalkalmazásokat írjanak Androidra és iOS-re JavaScript és CSS használatával. Minden mobilplatformnak saját ökoszisztémája van, és teljesen különböző fejlesztőeszközöket és nyelveket kínál – Java Androidra és Objective C(Swift) iOS-re. A JavaScript kód megfelelő natív API-kra történő lefordításához valamilyen proxy mechanizmusra van szükség. Pontosan ez az, amiért a NativeScript” futásidejű ” részei felelősek. Az Android Futásidejét úgy lehet elképzelni, mint” hidat ” a JavaScript és az Android világ között. A NativeScript alkalmazás Android egy szabványos natív csomag (apk), amely mellett a JavaScript fájlokat beágyazni a futásidejű is.

  • fő projektek
  • segítő projektek
  • építészeti Diagram
  • építési előfeltételek
  • Hogyan építsünk
  • hogyan futtassunk teszteket
  • Egyéb
  • segítség

további dokumentumok

számos Wiki oldal itt ír le néhány belső témát a futási időről

fő projektek

a repo a következő projektekben van felépítve (függőségek szerint rendezve):

  • android-metaadatok-generátor – generál metaadatokat szükséges az Android futásidejű.
  • android-binding-generator – lehetővé teszi a Java & Android típusok dinamikusan létre futásidőben. Szükséges a extend rutin.
  • android-runtime – tartalmazza a NativeScript Android futásidejének alapvető logikáját. Ez a projekt natív C++ kódot tartalmaz, és az Android NDK-ra van szüksége a megfelelő felépítéshez.
  • android-runtime-testapp – ez egy vanília Android alkalmazás, amely tartalmazza a teszteket a futásidejű projekt.

Helper projektek

  • android-statikus-kötés-generátor – build eszköz, amely létrehozza kötések alapján a felhasználó javascript kódot.
  • project-template – ez egy üres helyőrző Android alkalmazás projekt által használt NativeScript CLI, amikor az épület egy Android projekt.

architektúra Diagram

a NativeScript Android futásidejű architektúra az alábbi ábrán foglalható össze.

Android futásidejű diagram

a működésével kapcsolatos további részletekért olvassa el a dokumentációt.

Build előfeltételek

az alábbiakban bemutatjuk a futásidejű csomag elkészítésének minimális előfeltételeit.

  • telepítse a legújabb Android stúdiót.
  • az SDK kezelőből (Android Studio -> eszközök -> Android -> SDK Manager) telepítse a következő összetevőket:
    • Android API szint 23, 24, 25, 26, 27
    • Android NDK
    • Android Támogatási tároló
    • letöltési eszközök
    • CMake
    • LLDB
  • klónozza ezt az adattárat, valamint az almodulokat: git clone --recurse-submodules [email protected]:NativeScript/android-runtime.git

munka a futásidejű Android Studio

  • nyissa meg a test-app mappát az Android Studio. Ez egy érvényes Android projektet jelent, és képes létrehozni és futtatni egy tesztalkalmazást, amely a futási idővel dolgozik a forrásból.

Megjegyzés: előfordulhat, hogy a környezeti változók megőrzése érdekében a parancssorból kell futtatnia az Android stúdiót. Ez abban az esetben fordul elő, ha olyan hibákat kap, mint a “hiányzó npm”, ha a stúdiót a szokásos módon indítja el.

Hogyan építsünk

  • parancs futtatása

    Windows:

    gradlew

    Mac / Linux:

    ./gradlew
  • a build folyamat magában foglalja a futásidejű csomag elkészítését (mind optimalizált, mind pedig nem rögzített V8 szimbólumtáblával), valamint az android buildekhez használt összes kiegészítő eszközt: metaadat-generátor, kötésgenerátor, metaadat-generátor, statikus kötésgenerátor

  • a build eredménye a dist mappában lesz.

    Note: a fordítási idő felére csökkentése és csak a futásidejű csomag optimalizált (lecsupaszított) verziójának csomagolása írja ki a ‘feladatokat.generateRuntimeAar.execute () ‘ a buildben.gradle script.

hogyan kell futtatni a teszteket

  • menjen az almappába test-app Miután elkészítette a futási időt.

  • indítson el egy emulátort, vagy csatlakoztasson egy eszközt.

    Note: Keep in mind the device or emulator needs to have an sdcard mounted.

  • futtassa a parancsot

gradlew runtest

hozzájárulás

szeretjük a PRs-t! Nézze meg a hozzájáruló irányelveket. Ha szeretne hozzájárulni, de nem biztos benne, hol kezdje – keresse meg a help wantedcímkével ellátott problémákat.

Egyéb

  • további Chrome DevTools protokolltartományok végrehajtása

segítség kérése

kérjük, használja a github-problémákat szigorúan a hibák jelentéséhez vagy a funkciók kéréséhez. Általános kérdésekre és támogatásra, nézd meg a Stack Overflow – t, vagy kérdezd meg szakértőinket a NativeScript community Slack channel-ben.