EloView WebApps 및 WebViewController에서 로컬 구성은 어떻게 사용하나요?

이 문서에서는 EloView® WebApps 및 WebViewController (WVC)와 함께 로컬 구성을 사용하는 방법을 설명하여 Elo Android 디바이스에서 고급 브라우저 및 키오스크 구성 설정을 직접 적용합니다.

로컬 구성은 WebViewController (WVC)가 WVC가 시작될 때 Elo Android 디바이스에 로컬로 저장된 구성 설정을 사용하도록 허용합니다. 이러한 설정은 EloView 포털을 통해 제공되는 것 외에 추가 구성 옵션을 제공합니다.

⚠ 중요

EloView에서 로컬 구성을 활성화하면 WebViewController가 로컬 구성 파일을 찾도록 지시합니다. 이는 디바이스에 구성 파일을 생성, 다운로드 또는 복사하지 않습니다. 고객 또는 관리자가 구성 파일을 생성하고 물리적 Elo Android 디바이스의 지원되는 위치에 배치해야 합니다.

개요

WebViewController는 구성 정보를 두 가지 방법으로 수신할 수 있습니다:

로컬 구성 파일 – WVC는 디바이스의 루트 /sdcard/ 디렉터리에 저장된 지원되는 구성 파일을 읽습니다.
Android Intents – 커스텀 Android 애플리케이션이 WVC를 시작하고 프로그래밍 방식으로 구성 정보를 제공할 수 있습니다.

readLocalConfig 불리언 Intent 추가는 WebViewController가 launchContentSetting Intent 설정 대신 로컬 구성 파일을 사용하려고 시도하는지를 결정합니다.

readLocalConfig	동작
`true`	WVC가 지원되는 로컬 구성 파일을 사용하고 `launchContentSetting`을 무시하도록 요청합니다.
`false`	WVC는 `launchContentSetting`을 통해 시작 구성을 수신할 수 있습니다.

시작하기 전에

ℹ 시작하기 전에

구성 파일을 만들기 전에 배포에 필요한 WebViewController 설정을 확인하십시오.

Elo는 변경해야 하는 설정만 포함할 것을 권장합니다. 다른 설정은 기존 상태나 기본 동작을 유지하십시오.

EloView에서 로컬 구성 활성화하기

EloView에서 WebApp 콘텐츠를 구성할 때 콘텐츠 속성에서 로컬 구성을 활성화하십시오:

EloView 포털에서 해당 WebApp 콘텐츠 항목을 엽니다.
콘텐츠 세부정보 > 콘텐츠 속성으로 이동합니다.
강한>브라우저 설정에서 로컬 구성을 찾습니다.
강한>로컬 구성을 활성화됨 (활성)으로 설정합니다.
구성을 저장하거나 적용합니다.

⚠ 중요

이 설정을 활성화한다고 해서 구성 파일이 생성되거나 배포되지 않습니다. 구성 파일은 여전히 생성되어야 하며 대상 디바이스의 지원되는 위치에 복사되어야 합니다.

로컬 구성 파일 만들기 및 배치하기

WebViewController는 Java 속성 및 JSON 구성 파일을 지원합니다. 아래의 지원되는 파일 이름 중 하나를 사용하여 구성 파일을 /sdcard/ 디렉터리의 루트에 직접 배치합니다.

우선 순위	지원되는 파일 경로	형식
1 – 최고	`/sdcard/wvc_config.properties`	Java Properties
2	`/sdcard/wvc_config.prop`	Java Properties
3 – 최하	`/sdcard/wvc_config.json`	JSON

ℹ 파일 우선 순위

디바이스에 둘 이상의 지원된 구성 파일이 있는 경우, WebViewController는 우선 순위가 가장 높은 파일을 사용합니다. 예를 들어, wvc_config.properties는 wvc_config.prop 및 wvc_config.json보다 우선합니다.

⚠ 저장 경로 요구사항

파일은 /sdcard/ 바로 아래에 배치되어야 합니다. /sdcard/Download/와 같은 하위 폴더에 저장된 파일은 다른 경로이며 로컬 구성에 대해 문서화된 지원 위치 중 하나가 아닙니다.

WebViewController 구성 설정

로컬 구성은 다양한 WebViewController 설정을 지원합니다. 불리언 값은 true 또는 false를 사용합니다. 문자열 값은 JSON에서 따옴표로 묶이며 Java 속성 파일에 텍스트 값으로 입력됩니다.

브라우저 및 세션 설정

설정	유형	설명
`viewMode`	문자열	`전체 보기`를 사용하여 전체 화면 모드를 설정합니다. 다른 값은 폼 보기 모드를 사용합니다.
`layerType`	문자열	`HW`는 하드웨어 가속을 활성화합니다. 다른 값은 `SW`를 사용합니다. 하드웨어 가속은 비디오 재생을 위해 개발자 문서에서 권장됩니다.
`pinchZoom`	불리언	핀치 확대/축소를 활성화합니다.
`homePageTimeout`	문자열	홈 페이지로 돌아가기 전에 유휴 상태의 분 수. `0`, `never`, 또는 생략된 값은 타임아웃이 없음을 의미합니다.
`clearUserDataOnTimeout`	불리언	홈 페이지 타임아웃이 발생했을 때 사용자 데이터를 지웁니다.
`clearCookiesOnTimeout`	불리언	홈 페이지 타임아웃이 발생했을 때 쿠키를 지웁니다.
`ssl`	불리언	SSL을 활성화합니다.
`userAgent`	문자열	User-Agent 문자열을 설정합니다.
`virtualKeyboard`	불리언	가상 키보드를 비활성화하려면 `false`로 설정합니다.
`disableDownload`	불리언	다운로드를 비활성화하려면 `true`로 설정합니다. 이것은 또한 PDF도 비활성화합니다.
`showLoadingBar`	불리언	화면 상단에 로딩 바를 표시합니다.

네비게이션 바 설정

설정	유형	설명
`showNavBar`	불리언	화면 하단에 홈, 뒤로 및 앞으로 이동하는 네비게이션 바를 표시합니다.
`navBarBackgroundColor`	문자열	`#RRGGBB` 또는 `#AARRGGBB` 형식의 네비게이션 바 색상입니다.
`navBarAccentColor`	문자열	네비게이션 바 강조 색상입니다.

액션 바 설정

설정	유형	설명
`showActionBar`	불리언	화면 상단에 액션 바를 표시합니다.
`actionBarBackgroundColor`	문자열	액션 바 배경 색상입니다.
`actionBarBackgroundUrl`	문자열	액션 바 배경으로 사용되는 이미지의 URL입니다.
`actionBarAccentColor`	문자열	액션 바 강조 색상입니다.
`showActionBarLogo`	불리언	액션 바의 왼쪽에 로고를 표시합니다.
`actionBarLogoIconUrl`	문자열*	액션 바 아이콘으로 사용되는 이미지의 URL입니다.
`showActionBarTitle`	불리언	액션 바에 웹 페이지 제목을 표시합니다.
`showActionBarSubtitle`	불리언	액션 바에 웹 페이지 부제목을 표시합니다.
`showActionBarPrintBtn`	불리언	인쇄 버튼을 표시합니다.
`showActionBarShareBtn`	불리언	공유 버튼을 표시합니다.
`showActionBarInfoBtn`	불리언	정보 버튼을 표시합니다.

ℹ 문서 노트

소스 개발자 문서에서는 actionBarLogoIconUrl을 URL로 설명하지만, 그 소스 테이블에서는 해당 키가 불리언으로 레이블이 지정되어 있다고 보고했습니다. 이 설정은 URL을 나타내므로 이 문서에서 문자열로 표시됩니다. 대상 디바이스에서 사용되는 WebViewController 패키지의 동작을 확인하십시오.

PDF 설정

설정	유형	설명
`pdfSupport`	불리언	PDF 보기 기능을 활성화합니다.
`pdfHyperlinkSupport`	불리언	PDF 내 하이퍼링크를 활성화합니다.
`pdfSwipeHorizontal`	불리언	`true`로 설정하면 수평 PDF 스크롤을 활성화합니다.
`pdfShowScrollHandle`	불리언	PDF를 스크롤할 때 스크롤 핸들을 표시합니다.
`pdfFitToHeight`	불리언	PDF를 너비 대신 표시 높이에 맞춥니다.

예제 JSON 구성

다음의 요약된 예는 wvc_config.json 파일의 구조를 보여줍니다. 배포에 적합한 설정 및 값만 선택하십시오.

{
  "contentpath": "https://example.com",
  "viewMode": "Full View",
  "layerType": "HW",
  "pinchZoom": true,
  "homePageTimeout": "0",
  "showNavBar": true,
  "pdfSupport": true
}

지원되는 파일 이름 중 하나를 사용하여 /sdcard/에 직접 파일을 저장하십시오. 로컬 구성 파일을 사용하는 경우, readLocalConfig를 true로 설정하여 WebViewController를 시작하십시오.

Android Intents를 사용하여 WebViewController 구성하기

WebViewController는 Android Intents를 통해도 프로그래밍 방식으로 시작 및 구성할 수 있습니다. 이는 디바이스에 저장된 구성 파일을 사용하는 대안입니다.

예를 들어, WebViewController가 설치된 후, 커스텀 디바이스 에이전트 애플리케이션이 디바이스 워크플로의 일환으로 WVC를 제어할 적절한 Intents를 보낼 수 있습니다.

Intent 추가	유형	목적
`contentPath`	문자열	`http://`, `https://`, 또는 `file://`로 시작하는 홈페이지 URL입니다.
`readLocalConfig`	불리언	`true`일 때, WVC가 `launchContentSetting`을 무시하고 지원되는 로컬 구성 파일을 사용하도록 요청합니다.
`launchContentSetting`	문자열	뷰 모드, 네비게이션 바, 타임아웃 동작, PDF 동작 및 기타 지원 설정과 같은 시작 옵션을 포함하는 JSON 객체입니다.

⚠ 중요 – Intent 매개변수 이름

개발자 문서에서는 Intent 추가를 contentPath로 식별하지만, 샘플 명령에서는 소문자 contentpath를 사용합니다.

통합자는 설치된 WebViewController 버전 및 관련 개발자 패키지와 함께 제공되는 샘플 파일을 통해 정확한 Intent 추가 이름 및 값 인코딩을 확인해야 합니다.

문제 해결

문제	확인할 사항
로컬 구성이 적용되지 않음	로컬 구성이 활성화되었는지, 그리고 구성 파일이 지원되는 파일 이름 및 위치를 사용하는지 확인합니다.
JSON 구성 무시되는 것으로 보임	`wvc_config.properties` 또는 `wvc_config.prop`를 확인합니다. 두 파일은 `wvc_config.json`보다 우선 순위가 높습니다.
구성 파일이 감지되지 않음	파일이 `/sdcard/` 바로 아래에 있는지 확인합니다. `/sdcard/Download/`와 같은 위치의 파일은 문서화된 로컬 구성 경로 중 하나가 아닙니다.
`launchContentSetting` 설정이 사용되지 않음	`readLocalConfig`를 확인합니다. `true`로 설정하면 WVC가 대신 로컬 구성 파일을 사용하려고 시도합니다.
다운로드 또는 PDF 사용 불가	`disableDownload`가 `true`로 설정되어 있는지 확인합니다. 문서화된 동작에 따르면 이 옵션을 활성화하면 PDF도 비활성화됩니다.

로컬 구성 설정 체크리스트

배포에 필요한 WebViewController 설정만 확인합니다.
문서화된 설정 이름 및 값 유형을 사용하여 유효한 JSON 또는 Java 속성 구성 파일을 만듭니다.
지원되는 파일 이름 중 하나를 사용하여 파일을 저장합니다.
파일을 물리적 Elo Android 디바이스의 /sdcard/ 루트에 직접 복사합니다.
EloView에서 해당 WebApp에 대해 로컬 구성을 활성화합니다.
로컬 구성 파일을 사용하여 WVC를 시작할 때 readLocalConfig를 true로 설정합니다.
프로그래밍 방식으로 제어하려면 먼저 WebViewController를 설치한 다음 디바이스 에이전트 애플리케이션이 적절한 Android Intents를 보내도록 합니다.
대상 디바이스에서 구성을 테스트하고 WebViewController가 예상한 대로 동작하는지 확인합니다.

💡 팁

WebViewController의 동작 및 사용 가능한 설정은 WVC 버전에 따라 다를 수 있습니다. 자동 배포를 개발할 때는 구성 파일을 설치된 WebViewController 패키지 및 샘플 구성 파일과 비교하여 확인하십시오.

Please report any broken links by emailing elo.support@zebra.com and include a link to the knowledge article

검색

Elo 기술 지원에 오신 것을 환영합니다