NowWebService classe - Android

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 2 min. de leitura
  • . NowWebService A API fornece uma função que inicia um NowWebActivity que hospeda uma exibição da web.

    Tabela 1. Propriedades
    Nome Tipo Descrição
    configuração Classe NowServiceConfiguration - Android Informações de configuração do serviço associado, como ServiceNow URL da instância e o nome do pacote.

    NowWebService - launch(Contexto: Contexto, url: URL, nowWebTheme: NowWebTheme)

    Cria uma NowWebActivity que hospeda a exibição da web.

    Tabela 2. Parâmetros
    Nome Tipo Descrição
    contexto Contexto Contexto a ser usado para iniciar a atividade associada.
    URL URL URL da página da web a ser carregada. Esta página da web deve estar no destino ServiceNow instância com a qual o serviço foi inicializado.
    NowWebTheme NowWebTheme Opcional. NowWebTheme Objeto a ser aplicado aos elementos de IU do controlador de exibição.

    Tema padrão: Tema padrão

    Tabela 3. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo de código a seguir mostra como chamar esta função.

    suspend fun launchNowWeb() {
        val webService = getNowWebService()
    
        val webTheme = object : NowWebTheme {
            override val brand: Int
                get() = Color.BLUE
    
            override val textPrimary: Int
                get() = Color.BLACK
    
            //Override remaining theme colors
        }
        webService?.launch(activity, URL("https://instance-name.service-now.com"), webTheme)
    }

    NowWebService – preloadWebCache(preloadUris: List<URI>)

    Pré-carrega uma lista de java.net.URIs especificados em uma webview sem periféricos para preencher previamente o cache da webview com recursos armazenáveis em cache na página.

    Nota:
    A conclusão desta chamada de função é baseada em OnPageFinished() chamado na webview, que não leva em conta redirecionamentos ou recursos na página. Por causa disso, a pré-carga pode não estar totalmente concluída quando este método retornar.
    Tabela 4. Parâmetros
    Nome Tipo Descrição
    Pré-loadUris Lista Lista de java.net.URIs a serem pré-carregados. Todos os java.net.URIs devem ser relativos ou corresponder ao host atual configurado no NowSDK.
    Tabela 5. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como usar o. WebService.preloadWebCache() função para pré-carregar o. mesp página.

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

    NowWebService – updateTheme(nowWebTheme: NowWebTheme)

    Atualiza o tema de IU do NowWeb com o tema de IU especificado. Use esta função para atualizar o tema de IU da Web depois que ele tiver sido definido inicialmente usando iniciar () , como ao mudar o tema de claro para escuro.

    Tabela 6. Parâmetros
    Nome Tipo Descrição
    NowWebTheme NowWebTheme NowWebTheme Objeto a ser aplicado aos elementos de IU do controlador de exibição.
    Tabela 7. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo de código a seguir mostra como atualizar um tema de IU leve implementado usando iniciar () Para o tema de IU escuro usando UpdateTheme() função.

    val webService = getNowWebService()
    
    val lightTheme = object : NowWebTheme {
        override val brand: Int
            get() = Color.BLUE
    
        override val textPrimary: Int
            get() = Color.BLACK
    
        override val backgroundPrimary: Int
            get() = Color.WHITE
    
        // Override remaining theme colors
    }
    
    val darkTheme = object : NowWebTheme {
        override val brand: Int
            get() = Color.BLUE
    
        override val textPrimary: Int
            get() = Color.WHITE
    
        override val backgroundPrimary: Int
            get() = Color.BLACK
    
        // Override remaining theme colors
    }
    
    //launch NowWeb with light theme
    webService?.launch(activity, URL("https://instance-name.service-now.com"), lightTheme)
    
    //update NowWeb with dark theme
    webService?.updateTheme(darkTheme)