NowWebService 클래스 - Android

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 읽기2분
  • NowWebService API는 웹 뷰를 호스팅하는 NowWebActivity를 시작하는 함수를 제공합니다.

    표 1. 속성
    이름 유형 설명
    구성 NowServiceConfiguration 클래스 - Android 인스턴스 URL 및 패키지 이름과 같은 ServiceNow 관련 서비스에 대한 구성 정보입니다.

    NowWebService - launch(컨텍스트: 컨텍스트, URL: URL, 테마: NowWebTheme)

    웹 뷰를 호스팅하는 NowWebActivity를 작성합니다.

    표 2. 매개변수
    이름 유형 설명
    컨텍스트 컨텍스트 관련 활동을 시작하는 데 사용할 컨텍스트입니다.
    URL URL 로드할 웹 페이지의 URL입니다. 이 웹 페이지는 서비스가 초기화된 대상 ServiceNow 인스턴스에 있어야 합니다.
    주제 NowWebTheme 옵션입니다. NowWebTheme 뷰 컨트롤러의 UI 요소에 적용합니다.

    기본값: 기본 테마

    표 3. 반환
    유형 설명
    안 함

    다음 코드 예제에서는 이 함수를 호출하는 방법을 보여 줍니다.

    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
      })
    }

    NowWebService – preloadWebCache(preloadUris: List<URI>)

    헤드리스 웹 뷰에 지정된 java.net.URI 목록을 미리 로드하여 페이지에서 캐시 가능한 리소스로 webview 캐시를 미리 채웁니다.

    주:
    이 함수 호출의 완료는 웹뷰에서 호출되는 onPageFinished() 를 기반으로 하며, 페이지의 리디렉션 또는 리소스를 고려하지 않습니다. 이 때문에 이 메서드가 반환될 때 사전 로드가 완전히 완료되지 않을 수 있습니다.
    표 4. 매개변수
    이름 유형 설명
    preloadUris 목록 미리 로드할 java.net.URI 목록입니다. 모든 java.net.URI는 상대적이거나 NowSDK에 구성된 현재 호스트와 일치해야 합니다.
    표 5. 반환
    유형 설명
    안 함

    다음 예제는 webService.preloadWebCache() 함수를 사용하여 mesp 페이지를 미리 로드하는 방법을 보여줍니다.

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