---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Zeigen Sie Webseiten an, die auf Ihrem gehostet werden ServiceNowInstanz

# Zeigen Sie Webseiten an, die auf Ihrem gehostet werden ServiceNowInstanz {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 Minuten Lesedauer

Sie können Webseiten anzeigen, die in gehostet werden ServiceNowInstanz in Ihrer nativen Instanz AndroidAnwendung.
Die Mobile SDKBietet eine nahtlose Verarbeitung der erforderlichen Authentifizierung und Sitzungsverwaltung, während [Jetzt WebSDK](https://servicenow-prod.fluidtopics.net/UlTcBqh5wpfipIyYOrspMg#NowWebSDKAndroidAPI "Die Jetzt WebSDK Die Klasse bietet eine einzelne Funktion, mit der Sie Webseiten laden können, die auf Ihrem gehostet werden ServiceNowInstanz in einer nativen Webansicht und einem Cabrillo. Es verarbeitet die Anwenderauthentifizierung und die Sitzungsverwaltung automatisch, anstatt Anwender zu zwingen, sich über eine Anmeldungs-Webseite bei der Instanz anzumelden.")Die API bietet die Funktionalität, die für die Verarbeitung von Seiten erforderlich ist, die sich auf Ihrem befinden ServiceNowInstanz. Diese Webseiten verfügen über alle dynamischen Interaktionen, die auf möglich sind ServiceNowPlattform.

Um diese Funktionen zu verwenden, müssen Sie zuerst eine Instanz von erstellen Jetzt Webservice . Dazu müssen Sie anrufen [MakeWebservice()](https://servicenow-prod.fluidtopics.net/UlTcBqh5wpfipIyYOrspMg#NWebSDK-makeWebService_S_S_S_S "Erstellt einen Now Web-Service.")Methode und geben Sie die URL an ServiceNowInstanz und bereits initialisiert `Now SDK `. Außerdem müssen Sie importiert haben `Now Web `In Ihrer Anwendung. Sie sollten einen Verweis auf enthalten Jetzt Webservice Solange Sie verwenden `Now Web `Service.

Das folgende Beispiel zeigt, wie ein Now WebService-Objekt erstellt wird:  

    /**
     * Helper class used to handle different Now service instances.
     */
    @Singleton
    class SdkManager @Inject constructor() {

        private var nowWebService: NowWebService? = null

        /**
         * Create the NowWebService once in the lifetime of the application inside the Application class or
         * another manager class that will be injected into other classes via dagger/hilt.
         * NowWebService should be created after initializing the NowSDK
         */
        suspend fun getNowWebService(): NowWebService? {
            if (nowWebService != null) return nowWebService

            return NowWebSDK.makeWebService(URL("https://instance-name.service-now.com")).getOrThrow()
                .also { this.nowWebService = it }
        }
    }

## Laden Sie Seiten vorab, um die Now Web-Ladezeit zu verbessern

Sie können Seiten mit zwischenspeicherbaren Ressourcen im Hintergrund vorab laden, um die anfängliche Verbesserung zu verbessern Now Web Ladezeiten. Das folgende Beispiel zeigt, wie verwendet wird Webservice.preloadWebCache() Funktion zum Vorladen von `Mesp `Seite. Diese Methode verwendet eine Liste von URIs, um weitere Seiten vorab abzurufen.

    suspend fun preloadNowWeb() {
      val webService = sdkmanager.getNowWebService()
      webService.preloadWebCache(listOf(URI("mesp")))
    }

## Erstellen Sie Ansichten, um Webinhalte anzuzeigen

Nachdem Sie eine Instanz von instanziiert haben Jetzt Webservice , Können Sie damit eine Aktivität starten, um Webseiten anzuzeigen, die auf Ihrem gehostet werden ServiceNowInstanz.

Das folgende Beispiel zeigt, wie eine NowWeb-Aktivität gestartet wird:  

    //Activity that will start the NowWeb
    class MainActivity : AppCompatActivity() {

      @Inject
      lateinit var sdkManager: SdkManager

      override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        // Start NowWeb
        lifecycleScope.launch {
          sdkManager.getNowWebService()?.launch(this@MainActivity, URL("https://instance-name.service-now.com"), object : NowWebTheme{})
        }
      }
    }

In diesem Beispiel urlIst die URL der ersten Seite, die in der Ansicht geladen werden soll. Diese URL muss auf eine Seite verweisen, die auf der angegebenen gehostet wird ServiceNowInstanz.

## Unterstützung des Farbdesigns für NowWeb-UI-Elemente

Sie können beim Aufrufen des Now Webservice ein anwenderdefiniertes Farbdesign angeben, das für alle UI-Elemente in einer Ansicht gilt Starten () Methode. Um dieses anwenderdefinierte Farbdesign zu erstellen, erstellen Sie einen Typ, der implementiert Now WebTheme Schnittstelle erstellen und im Designparameter von übergeben Jetzt Webservice.Start() Rufen Sie an.  

    lifecycleScope.launch {
      sdkManager.getNowWebService()?.launch(this@MainActivity, URL("https://instance-name.service-now.com"), object : NowWebTheme {
        override val brand: NowUIAdaptiveColor
          // Setting lightColor only. For dark theme default color will be used
          get() = NowUIAdaptiveColor(lightColor = Color.BLACK)

        override val primary: NowUIAdaptiveColor
          // Setting both lightColor and darkColor
          get() = NowUIAdaptiveColor(lightColor = Color.BLACK, darkColor = Color.WHITE)

        // Override the rest of color variables
      })
    }

Weitere Informationen zum Anwenden von Farbthemen in einer Webansicht finden Sie unter [Verwenden Sie NowUIColoring, um NowWebTheme und NowChatTheme zu entwerfen](https://servicenow-prod.fluidtopics.net/6s1jewRHKCiU9F1iR7jvDQ "Die Jetzt Farbe Die Schnittstelle enthält alle Farben, die von allen NowSDK-Modulen verwendet werden.").

