소스 코드 보기

소스 뷰어 로드, 구성 및 열기
- 소스 뷰어 구성
- 소스 뷰어 열기
소스 뷰어 사용자 인터페이스

웹 브라우저에서 HTML 페이지의 소스 코드를 볼 수 있는 것과 마찬가지로 HTML 기반 AIR 응용 프로그램의 소스 코드를 볼 수 있습니다. Adobe® AIR® SDK에는 응용 프로그램에서 최종 사용자에게 소스 코드를 보여 줄 때 사용할 수 있는 AIRSourceViewer.js라는 JavaScript 파일이 포함되어 있습니다.

소스 뷰어 로드, 구성 및 열기

소스 뷰어 코드는 JavaScript 파일인 AIRSourceViewer.js에 포함되어 있으며, 이 파일은 AIR SDK의 frameworks 디렉토리에 있습니다. 응용 프로그램에서 소스 뷰어를 사용하려면 AIRSourceViewer.js를 응용 프로그램 프로젝트 디렉토리에 복사하고 응용 프로그램의 기본 HTML 파일에서 script 태그를 사용하여 로드합니다.

<script type="text/javascript" src="AIRSourceViewer.js"></script>

AIRSourceViewer.js 파일은 SourceViewer 클래스를 정의합니다. JavaScript 코드에서는 air.SourceViewer 를 호출하여 이 클래스에 액세스할 수 있습니다.

SourceViewer 클래스는 getDefault() , setup() 및 viewSource() 라는 세 가지 메서드를 정의합니다.

메서드	설명
`getDefault()`	정적 메서드입니다. 다른 메서드를 호출하는 데 사용할 수 있는 SourceViewer 인스턴스를 반환합니다.
`setup()`	소스 뷰어에 구성 설정을 적용합니다. 자세한 내용은 소스 뷰어 구성 을 참조하십시오.
`viewSource()`	사용자가 호스트 응용 프로그램의 소스 파일을 찾아보고 열 수 있는 새 윈도우를 엽니다.

참고: 소스 뷰어를 사용하는 코드는 응용 프로그램 보안 샌드박스(응용 프로그램 디렉토리의 파일)에 있어야 합니다.

예를 들어, 다음 JavaScript 코드는 소스 뷰어 객체를 인스턴스화하고 모든 소스 파일을 나열하는 소스 뷰어 윈도우를 엽니다.

var viewer = air.SourceViewer.getDefault(); 
viewer.viewSource();

소스 뷰어 구성

config() 메서드는 지정된 설정을 소스 뷰어에 적용합니다. 이 메서드는 configObject 매개 변수 하나만 사용합니다. configObject 객체에는 소스 뷰어에 대한 구성 설정을 정의하는 속성이 있습니다. 속성은 default , exclude , initialPosition , modal , typesToRemove 및 typesToAdd 입니다.

default

소스 뷰어에 표시할 초기 파일에 대한 상대 경로를 지정하는 문자열입니다.

예를 들어, 다음 JavaScript 코드는 index.html 파일이 초기 파일로 표시된 상태로 소스 뷰어 윈도우를 엽니다.

var viewer = air.SourceViewer.getDefault(); 
var configObj = {}; 
configObj.default = "index.html"; 
viewer.viewSource(configObj);

exclude

소스 뷰어 목록에서 제외할 파일이나 디렉토리를 지정하는 문자열 배열입니다. 경로는 응용 프로그램 디렉토리에 대해 상대적입니다. 와일드카드 문자는 사용할 수 없습니다.

예를 들어, 다음 JavaScript 코드는 소스 뷰어 윈도우를 열고 AIRSourceViewer.js 파일과 Images 및 Sounds 하위 디렉토리의 파일을 제외한 모든 소스 파일을 나열합니다.

var viewer = air.SourceViewer.getDefault(); 
var configObj = {}; 
configObj.exclude = ["AIRSourceViewer.js", "Images" "Sounds"]; 
viewer.viewSource(configObj);

initialPosition

소스 뷰어 윈도우의 초기 x 및 y 좌표를 지정하는 숫자 두 개를 포함하는 배열입니다.

예를 들어, 다음 JavaScript 코드는 화면 좌표 [40, 60](X = 40, Y = 60)에 소스 뷰어 윈도우를 엽니다.

var viewer = air.SourceViewer.getDefault(); 
var configObj = {}; 
configObj.initialPosition = [40, 60]; 
viewer.viewSource(configObj);

modal

소스 뷰어 윈도우가 모달 윈도우(true)인지 비 모달 윈도우(false)인지를 지정하는 부울 값입니다. 기본적으로 소스 뷰어 윈도우는 모달 윈도우입니다.

예를 들어, 다음 JavaScript 코드는 사용자가 소스 뷰어 윈도우와 다른 응용 프로그램 윈도우를 동시에 사용할 수 있도록 소스 뷰어 윈도우를 엽니다.

var viewer = air.SourceViewer.getDefault(); 
var configObj = {}; 
configObj.modal = false; 
viewer.viewSource(configObj);

typesToAdd

기본 유형과 함께 소스 뷰어 목록에 포함될 파일 유형을 지정하는 문자열 배열입니다.

기본적으로 소스 뷰어 윈도우는 다음 파일 유형을 나열합니다.

텍스트 파일 - TXT, XML, MXML, HTM, HTML, JS, AS, CSS, INI, BAT, PROPERTIES, CONFIG
이미지 파일 - JPG, JPEG, PNG, GIF

값을 지정하지 않으면 typesToExclude 속성에 지정된 유형을 제외한 모든 기본 유형이 포함됩니다.

예를 들어, 다음 JavaScript 코드는 VCF와 VCARD 파일이 포함된 소스 뷰어 윈도우를 엽니다.
```
var viewer = air.SourceViewer.getDefault(); 
var configObj = {}; 
configObj.typesToAdd = ["text.vcf", "text.vcard"]; 
viewer.viewSource(configObj);
```
나열하는 각 파일 유형에 대해 "text"(텍스트 파일 유형) 또는 "image"(이미지 파일 유형)를 지정해야 합니다.

typesToExclude

소스 뷰어에서 제외할 파일 유형을 지정하는 문자열 배열입니다.

기본적으로 소스 뷰어 윈도우는 다음 파일 유형을 나열합니다.

텍스트 파일 - TXT, XML, MXML, HTM, HTML, JS, AS, CSS, INI, BAT, PROPERTIES, CONFIG
이미지 파일 - JPG, JPEG, PNG, GIF

예를 들어, 다음 JavaScript 코드는 GIF나 XML 파일을 나열하지 않도록 소스 뷰어 윈도우를 엽니다.
```
var viewer = air.SourceViewer.getDefault(); 
var configObj = {}; 
configObj.typesToExclude = ["image.gif", "text.xml"]; 
viewer.viewSource(configObj);
```
나열하는 각 파일 유형에 대해 "text" (텍스트 파일 유형) 또는 "image" (이미지 파일 유형)를 지정해야 합니다.

소스 뷰어 열기

사용자가 선택하여 소스 뷰어 코드를 호출할 수 있는 링크, 버튼, 메뉴 명령 등과 같은 사용자 인터페이스 요소가 있어야 합니다. 예를 들어, 다음은 사용자가 링크를 클릭하면 소스 뷰어를 여는 간단한 응용 프로그램입니다.

<html> 
    <head> 
        <title>Source Viewer Sample</title> 
        <script type="text/javascript" src="AIRSourceViewer.js"></script> 
        <script type="text/javascript"> 
            function showSources(){ 
                var viewer = air.SourceViewer.getDefault(); 
                viewer.viewSource() 
            } 
        </script> 
    </head> 
    <body> 
        <p>Click to view the source files.</p> 
        <input type="button"  
            onclick="showSources()"  
            value="View Source" /> 
    </body> 
</html>

소스 뷰어 사용자 인터페이스

응용 프로그램에서 SourceViewer 객체의 viewSource() 메서드를 호출하면 AIR 응용 프로그램이 소스 뷰어 윈도우를 엽니다. 이 윈도우 왼쪽에는 소스 파일 및 디렉토리 목록이 있고 오른쪽에는 선택한 파일의 소스 코드를 표시하는 디스플레이 영역이 있습니다.

전체 화면으로 그래픽 보기

디렉토리는 대괄호 안에 나열됩니다. 사용자는 대괄호를 클릭하여 디렉토리 목록을 확장하거나 축소할 수 있습니다.

소스 뷰어는 인식된 확장명을 가진 텍스트 파일(, HTML, JS, TXT, XML 등)이나 인식된 이미지 확장명을 가진 이미지 파일(JPG, JPEG, PNG 및 GIF)의 소스를 표시할 수 있습니다. 사용자가 인식된 파일 확장명이 없는 파일을 선택하면 "이 파일 유형에서 텍스트 내용을 검색할 수 없습니다."라는 오류 메시지가 표시됩니다.

setup() 메서드를 통해 제외된 모든 소스 파일은 나열되지 않습니다( 소스 뷰어 로드, 구성 및 열기 참조).