NowWebService 클래스 - Android

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 읽기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 목록을 미리로드하여 페이지의 캐시 가능한 리소스로 웹 뷰 캐시를 미리 채웁니다.

    주:
    이 함수 호출의 완료는 웹뷰에서 호출되는 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")
        )
      )
    }