---
sourceDocument: 호주 API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# 인스턴스에 ServiceNow 호스팅된 웹 페이지 표시

# 인스턴스에 ServiceNow 호스팅된 웹 페이지 표시 {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 4분

인스턴스 내에서 ServiceNow 호스팅된 웹 페이지를 네이티브 Android 애플리케이션에 표시할 수 있습니다.
Mobile SDK 이는 필요한 인증 및 세션 관리를 원활하게 처리하며, [NowWebSDK](https://servicenow-prod.fluidtopics.net/1fIFLHO9j8wr9Kd2VCr7Lw#NowWebSDKAndroidAPI "NowWebSDK 클래스는 인스턴스에 호스팅 ServiceNow 된 웹 페이지를 네이티브 웹 뷰 및 Cabrillo에서 로드할 수 있는 단일 함수를 제공합니다. 사용자가 로그인 웹 페이지를 통해 인스턴스에 로그인하도록 강요하는 대신 사용자 인증 및 세션 관리를 자동으로 처리합니다.") API는 인스턴스에 ServiceNow 있는 페이지를 처리하는 데 필요한 기능을 제공합니다. 이러한 웹 페이지에는 플랫폼에서 가능한 모든 동적 상호작용이 있습니다.ServiceNow

이러한 기능을 사용하려면 먼저 NowWebService의 인스턴스를 만들어야 합니다. 이렇게 하려면 [makeWebService()](https://servicenow-prod.fluidtopics.net/1fIFLHO9j8wr9Kd2VCr7Lw#NWebSDK-makeWebService_S_S_S_S "NowWeb 서비스를 작성합니다.") 메서드를 호출하고 인스턴스와 이미 초기화된 `NowSDK`에 대한 ServiceNow URL을 제공해야 합니다. 또한 애플리케이션 내에서 `NowWeb` 을 임포트해야 합니다. `NowWeb` 서비스를 사용하는 동안 NowWebService에 대한 참조를 유지해야 합니다.

다음은 NowWebService 객체를 생성하는 방법의 예를 보여줍니다.  

    /**
     * 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 }
        }
    }

## NowWeb 로드 시간을 개선하기 위해 페이지 미리 로드

백그라운드에서 캐시 가능한 자원이 있는 페이지를 미리 로드하여 초기 NowWeb 로드 시간을 개선할 수 있습니다. 다음 예제는 webService.preloadWebCache() 함수를 사용하여 `mesp` 페이지를 미리 로드하는 방법을 보여줍니다. 이 메서드는 URI 목록을 사용하여 더 많은 페이지를 미리 가져옵니다.

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

## 웹 컨텐츠를 표시할 뷰 생성

NowWebService의 인스턴스를 인스턴스화한 후 이를 사용하여 인스턴스에 호스팅된 ServiceNow 웹 페이지를 표시하는 활동을 시작할 수 있습니다.

다음 예는 NowWeb 활동을 시작하는 방법을 보여줍니다.  

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

이 예 url 에서는 뷰 내에서 로드할 초기 페이지의 URL입니다. 이 URL은 지정된 ServiceNow 인스턴스에서 호스팅되는 페이지를 가리켜야 합니다.

## NowWeb UI 요소에 대한 색상 테마 지원

NowWebService launch() 메서드를 호출할 때 뷰 내의 모든 UI 요소에 적용되는 사용자 지정 색상 테마를 지정할 수 있습니다. 이 사용자 지정 색 테마를 만들려면 NowWebTheme 인터페이스를 구현하는 형식을 만들고 NowWebService.launch() 호출의 테마 매개변수에 전달합니다.  

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

웹 뷰 내에서 색상 테마를 적용하는 방법에 대한 자세한 내용은 다음 문서를 참조하십시오 [NowUIColoring을 사용하여 NowWebTheme 및 NowChatTheme 테마 지정](https://servicenow-prod.fluidtopics.net/2FBS3FqANlSbQUZzXqc_Fw "NowUIColoring 인터페이스에는 모든 NowSDK 모듈에서 사용하는 모든 색상이 포함되어 있습니다.").