전용 브라우저 가이드

이 장에서는 전용 브라우저에 대한 개요를 설명한다.

• 전용 브라우저 개요
• 구성 파일 및 내용
• 전용 브라우저와 범용 브라우저 비교

전용 브라우저는 다음과 같은 기능 및 특징을 가지고 있다.

전용 브라우저는 별도의 파라미터가 없는 경우, 전용 브라우저 파일이 위치한 디렉토리의 “xFrame5BrowserDev.ini” 파일을 사용한다. 구성 파일은 “UTF-16 Little Endian” 형식으로 인코딩 되어 있어야 한다.

구성파일은 기본설치파일에 포함되지 않으므로, 필요시 아래의 구성 파일 예시를 참고하여 작성해야 한다.

별도의 구성 파일을 지정할 필요가 있는 경우에는 --xf5-config-filename 파라미터를 이용하여 구성 파일의 절대 경로를 지정한다.

구성 파일은 일반적인 ini 파일의 구조를 가지며, “XFRAME5BROWSER” 섹션값을 사용한다.

아래는 구성 파일에 대한 예시이다.

[XFRAME5BROWSER]
;어플리케이션 이름 지정
APP_NAME = XFRAME5

;전용 브라우저 종료시 종료 확인 메시지 박스 표시 여부 (기본값: TRUE)
APP_EXIT_CHECK = TRUE

;전용 브라우저 종료시 종료 확인 메시지 박스에 표시될 메시지 내용 (기본값: 종료하시겠습니까?)
;APP_EXIT_MSG = Are you want to exit?

;전용 브라우저 browserexit API 호출이 아닌 방법으로 종료시 검사 여부 (기본값: FALSE)
APP_ABNORMAL_EXIT_CHECK = FALSE

;전용 브라우저 browserexit API 호출이 아닌 방법으로 종료시 검사시
;메시지 박스에 표시될 메시지 내용 (기본값: 정상적인 방식으로 종료해주세요!)

APP_ABNORMAL_EXIT_MSG = 정상적인 방식으로 종료해주세요!

;다중실행 방지키(키값이 없거나, 빈값이면 다중실행가능)
INSTANCENAME = xFrame5Browser
;INSTANCENAME = xFrame5Browser_DEV

;다중실행 방지 에러메시지(기본값: xFrame5Browser already existed.)
INSTANCE_ERROR_MSG = 전용브라우저가 이미 실행중입니다.

;다중실행 가능 최대 갯수(기본값: 1)
; 3 을 설정하면 최대 3 개까지 동시실행 가능
INSTANCE_LIMIT = 3

;전용브라우저 아이콘
ICON_FILE = xframe5.ico
;ICON_FILE = ..\xframe5.ico
;ICON_FILE = c:\xframe5\xframe5.ico
;다운로드 완료된 파일 실행여부

OPEN_DOWNLOAD_FILE=0
;파일 다운로드시 파일선택대화상자 표시여부
HIDE_FILEDIALOG=0

;debug.log 에 출력할 로그 레벨
LOG_SEVERITY=disable

;console.log 파일에 출력할 로그 레벨
CONSOLE_LOG_LEVEL=disable

;console.log 파일의 크기(MB 단위)
CONSOLE_LOG_LIMIT=1

;오른쪽마우스 클릭시 컨텍스트메뉴 표시여부(기본값:0 표시)
;xFrame5 엔진에서 표시하는 컨텍스트메뉴는 제외
HIDE_CONTEXTMENU=0

;컨텍스트메뉴에 개발자도구 항목 표시여부부(기본값:0 표시안함)
ADD_CONTEXTMENU_DEVTOOLS=1

;메시지 내용
LOADINGDLG_MSG=로딩중

;대화상자크기
;width,height
LOADINGDLG_SIZE=331,221

;대화상자 배경이미지
;절대경로 또는 상대경로(bmp 파일)
;LOADINGDLG_BACKIMAGE=loadingdlg.bmp
LOADINGDLG_BACKIMAGE=C:\\xFrame5\\xFrame5Browser\\loadingdlg.bmp

;메시지 폰트
;글꼴, 크기, 굵게, 기울임, 밑줄, 취소선
LOADINGDLG_MSG_FONT=궁서,20,1,1,0,0

;메시지 전경색
;Red, Green, Blue
LOADINGDLG_MSG_FORECOLOR=255,0,0

;메시지 배경색
;Red, Green, Blue
LOADINGDLG_MSG_BACKCOLOR=241,241,241

;메시지 위치 및 크기
;left,top,width,height
LOADINGDLG_MSG_POS=20,70,290,130

;메시지 표시여부(0:비표시, 1:표시(기본값))
LOADINGDLG_MSG_SHOW=0

;대화상자 배경이미지 배열 순환 간격(기본값:300ms)
LOADINGDLG_BACKIMAGEINTERVAL=200

;대화상자 배경이미지 배열(최대 9 개)
LOADINGDLG_BACKIMAGE_1=C:\\xFrame5\\xFrame5Browser\\loadingdlg1.bmp
LOADINGDLG_BACKIMAGE_2=C:\\xFrame5\\xFrame5Browser\\loadingdlg2.bmp
LOADINGDLG_BACKIMAGE_3=C:\\xFrame5\\xFrame5Browser\\loadingdlg3.bmp
LOADINGDLG_BACKIMAGE_4=C:\\xFrame5\\xFrame5Browser\\loadingdlg4.bmp

;최소 글꼴 크기 지정(px 단위)
MIN_FONT_SIZE=6

;기동파라미터에 URL정보(--url)가 없으면 프로세스 종료 여부(0:처리안함(기본값), 1: URL정보 없으면 종료)
EXIT_EMPTY_URL=0

전용 브라우저와 범용 브라우저와의 비교 내용은 아래와 같다. 범용 브라우저는 IE, Edge, Chrome 과 같은 일반적인 웹 브라우저를 말한다.

이 장에서는 전용 브라우저 파라미터에 대해서 설명한다.

• 전용 브라우저 형식 및 파라미터
• 기본 파라미터
• 확장 파라미터

전용 브라우저 형식은 아래와 같다. 파라미터 정의 방식은 파라미터만 정의하여 특정 기능을 수행하도록 하는 방식이다.

크로미움 브라우저가 정의한 파라미터를 “기본 파라미터”라고 정의하고, 전용 브라우저에서 확장한 파라미터를 “확장 파라미터”로 명명한다.

지정 가능한 기본 파라미터의 값은 아래와 같다. (파라미터 이름은 편의상 “--“를 제외하여 표시하였다.)
(관련 URL: https://peter.sh/experiments/chromium-command-line-switches/)

  (https://casternet.com/neo/bbs/view.php?bd=notice&no=79)

지정 가능한 확장 파라미터의 값은 아래와 같다. (파라미터 이름은 편의상 “--“를 제외하여 표시하였다.)

이 장에서는 전용 브라우저의 단축키에 대해서 설명한다.

• 단축키 정보

전용브라우저에서 지원하는 단축키 정보는 아래와 같다.

이 장에서는 전용 브라우저와 개발툴 연동에 대해서 설명한다.

• 개발툴 연동
• 기동 파라미터 설정

개발툴에서 전용브라우저를 기동하기 위해서는 전용 브라우저 실행파일이 개발툴 디렉토리 하위에 위치해야 한다.

개발툴에서 전용브라우저로 미리보기를 실행하기 위해서 아래와 같이 설정한다.

개발툴의 환경파일에서 기동파라미터를 설정할 수 있다.

• 개발툴에서 전용브라우저 미리보기 실행시 적용되는 기본 기동파라미터를 제거할 수 있다.
• 환경파일 : 개발툴설치디렉토리/config/xFrame5BrowserDev.ini (없는 경우, 새로 생성)

기본 기동파라미터 정보는 아래와 같다.(“CMD_No”형식으로 사용하고, 숫자는 연속적이어야 한다.) 파일이 없는 경우, 아래의 기동파라미터가 기본으로 적용된다.

[XFRAME5BROWSER]
CMD_1=allow-shortcut-refresh
CMD_2=allow-shortcut-showdevtools
CMD_3=disable-web-security
CMD_4=allow-file-access-from-files
CMD_5=disable-features=TSFImeSupport

예 1) 기동파라미터 “disable-web-security”를 제거

[XFRAME5BROWSER]
CMD_1=allow-shortcut-refresh
CMD_2=allow-shortcut-showdevtools
CMD_3=allow-file-access-from-files
CMD_4=disable-features=TSFImeSupport

예 2) 기동파라미터 “show-devtools”를 추가

[XFRAME5BROWSER]
CMD_1=allow-shortcut-refresh
CMD_2=allow-shortcut-showdevtools
CMD_3=disable-web-security
CMD_4=allow-file-access-from-files
CMD_5=disable-features=TSFImeSupport
CMD_6=show-devtools