Docs: L10N of remaining M Preview docs (ko).

page.title=앱용 자동 백업

page.tags=backup, previewresources, androidm

page.keywords=백업, 자동 백업, 미리 보기

page.image=images/cards/card-auto-backup_2x.png

@jd:body

<div id="qv-wrapper">

  <div id="qv">

    <h2>이 문서의 내용</h2>

      <ol>

        <li><a href="#overview">개요</a></li>

        <li><a href="#configuring">데이터 백업 구성</a></li>

        <li><a href="#testing">백업 구성 테스트</a></li>

        <li><a href="#issues">알려진 문제</a></li>

      </ol>

  </div>

</div>

<p>

  사용자는 앱 내에서 데이터를 생성하고 기본 설정을 설정하는 데 상당한 시간과 노력을 들이는 경우가 빈번합니다.

 사용자가 고장 난 기기를 교체하거나 새것으로 업그레이드하면 그러한 데이터를 보존해 두는 것이 훌륭한 사용자 환경을 보장하는 데 중요한 부분을 차지합니다.

 Android M 미리 보기 시스템에서 실행되는 기기는 이러한 상황에서 사용자에게 좋은 환경을 보장하는 데 도움을 주기 위해 앱 데이터를 Google Drive에 자동으로 백업합니다.

 이런 앱 데이터는 사용자가 기기를 바꾸거나 업그레이드하면 자동으로 복원됩니다.

</p>

<p>

  자동 백업 기능은 Android M 미리 보기에서 실행되는 기기에 설치된 모든 앱에 활성화되어 있습니다. 달리 앱 코드를 추가하지 않아도 됩니다.

 시스템은 사용자에게 자동 데이터 백업에서 옵트아웃할 수도 있습니다.

 앱에서 어떤 데이터를 백업할지 제한하는 쪽을 선택할 수도 있습니다.

</p>

<p>

  이 문서에서는 새로운 시스템 동작과 앱에 대해 어느 데이터를 백업할지 지정하는 방법을 설명합니다.

</p>

<h2 id="overview">개요</h2>

<p>

  자동 백업 기능은 앱이 사용자 기기에서 생성한 데이터를 보존하기 위해 해당 데이터를 사용자의 Google Drive 계정에 업로드하고 암호화합니다.

 데이터 저장에 대해 개발자나 사용자에게 아무런 요금도 부과하지 않고, 저장된 데이터는 사용자 개인의 Drive 할당량을 사용한 것으로 감안하지 않습니다.

 M 미리 보기 시행 기간 중 사용자는 Android 앱 한 개당 최대 25MB까지 저장할 수 있습니다.

</p>

<p>

  자동 백업은 24시간마다 한 번씩, 기기가 유휴 상태일 때, 충전 중일 때 및 Wi-Fi 네트워크에 연결될 때마다 수행합니다.

 이러한 조건에 부합하면 백업 관리자 서비스가 이용 가능한 모든 백업 데이터를 클라우드에 업로드합니다.

 사용자가 새 기기로 전환하거나 백업된 앱을 제거했다가 다시 설치하면 복원 작업이 백업된 데이터를 새로 설치된 앱의 데이터 디렉터리 안에 복사합니다.

</p>

<p class="note">

  <strong>참고:</strong> 레거시 <a href="{@docRoot}google/backup/index.html">Android 백업 서비스</a>를 이용하는 앱의 경우, 이 새 동작이 적용되지 않고 기존 백업 동작이 평소처럼 작동합니다.

</p>

<h3 id="auto-exclude">자동으로 배제된 데이터 파일</h3>

<p>

  데이터 중에는 예를 들어 임시 파일과 캐시 등 백업하지 않아도 되는 것도 있습니다. 따라서 자동 백업 서비스는 특정 데이터 파일을 기본적으로 배제합니다.

</p>

<ul>

  <li>디렉터리 내의 파일 중 {@link android.content.Context#getCacheDir

    getCacheDir()} 및 {@link android.content.ContextWrapper#getCodeCacheDir getCodeCacheDir()}

 메서드로 참조되는 파일.

  </li>

  <li>외부 저장소에 위치한 파일 중(디렉터리에 상주하는 것이 아닌 한) 

{@link android.content.Context#getExternalFilesDir getExternalFilesDir()}

 메서드로 참조되는 파일.

  </li>

  <li>디렉터리에 위치한 파일 중 

{@link android.content.Context#getNoBackupFilesDir getNoBackupFilesDir()} 메서드로 참조되는 파일.

  </li>

</ul>

<h2 id="configuring">데이터 백업 구성</h2>

<p>

  M 미리 보기 기기에 설치된 앱이 생성한 데이터는 모두 백업됩니다. 다만 이전 섹션에서 나열한 자동으로 배제되는 파일만은 예외입니다.

 앱에서 어느 데이터를 백업할지 좀 더 상세하게 제한하고 구성하려면 앱 매니페스트에 있는 설정을 사용하면 됩니다.

</p>

<h3 id="include-exclude">데이터 포함 또는 배제</h3>

<p>

  앱에 필요한 데이터가 무엇이며 어떤 식으로 저장하는지에 따라 특정 파일이나 디렉터리를 포함 또는 배제하기 위해 특정한 규칙을 설정해야 할 수 있습니다.

 자동 백업 서비스는 이러한 백업 규칙 설정을 지원하는 데 XML 구성 파일과 앱 매니페스트를 사용하는 방식을 씁니다.

 앱 매니페스트에서는 다음 예에서 표시된 것처럼 백업 구성표 구성 파일을 지정하면 됩니다.

</p>

<pre>

<?xml version="1.0" encoding="utf-8"?>

<manifest xmlns:android="http://schemas.android.com/apk/res/android"

        xmlns:tools="http://schemas.android.com/tools"

        package="com.my.appexample">

    <uses-sdk android:minSdkVersion="MNC"/>

    <uses-sdk android:targetSdkVersion="MNC"/>

    <app ...

<strong>        android:fullBackupContent="&#64;xml/mybackupscheme"&gt;</strong>

    </app>

    ...

</manifest>

</pre>

<p>

  이 예시 코드에서는 <code>android:fullBackupContent</code> 특성이 XML 파일을 나타냅니다. 이는 앱 개발 프로젝트의 <code>res/xml/</code> 디렉터리 내에 위치하며, 일명 <code>mybackupscheme.xml</code>이라고 합니다.

 이 구성 파일에는 어느 파일이 백업되는지에 대한 규칙이 포함되어 있습니다.

 다음 예시 코드는 특정 파일을 백업에서 배제하는 구성 파일을 나타낸 것입니다.

</p>

<pre>

<?xml version="1.0" encoding="utf-8"?>

<full-backup-content>

    <exclude domain="database" path="device_info.db"/>

</full-backup-content>

</pre>

<p>

  이 예에서의 백업 구성은 특정 데이터베이스 파일만 백업되지 않게 배제합니다.

  나머지 파일은 모두 백업됩니다.

</p>

<h4>백업 구성 구문</h4>

<p>

  백업 서비스 구성을 사용하면 구체적으로 어느 파일을 백업에 포함시키고 백업에서 배제할지 지정할 수 있게 해줍니다.

 데이터 백업 구성 XML 파일에 사용되는 구문은 다음과 같습니다.

</p>

<pre>

<full-backup-content>

    <include domain=["file" | "database" | "sharedpref" | "external" | "root"] path="string" />

    <exclude domain=["file" | "database" | "sharedpref" | "external" | "root"] path="string" />

</full-backup-content>

</pre>

<p>

  다음의 요소와 특성을 사용하면 어느 파일을 백업에 포함시키거나 백업에서 배제할지 지정할 수 있게 해줍니다.

</p>

<ul>

  <li>

  <code>&lt;include&gt;</code>. 이 요소는 일련의 리소스를 백업하기로 지정하는 경우 사용하십시오. 시스템이 기본적으로 앱 안의 모든 데이터를 백업하는 대신 이 방식을 쓰면 됩니다.

 예를 들어 <code>&lt;include&gt;</code> 태그를 지정하면 시스템은 이 요소로 <em>지정된 리소스만</em> 백업합니다.

  </li>

  <li>

  <code>&lt;exclude&gt;</code>. 이 요소는 일련의 리소스를 백업에서 배제하기로 지정하는 데 사용하세요.

 시스템이 앱 안의 모든 데이터를 백업하되, 이 요소로 지정된 리소스만 제외합니다.

  </li>

  <li>

  <code>domain.</code> 백업에 포함시키거나 백업에서 배제하고자 하는 리소스 유형입니다. 이 특성에 대해 지정할 수 있는 유효한 값에는 다음과 같은 것들이 있습니다.

  </li>

  <li style="list-style: none">

  <ul>

    <li>

    <code>root</code>. 리소스가 앱의 루트 디렉터리에 있음을 나타냅니다.

    </li>

    <li>

    <code>file</code>. 디렉터리 내에 있는 리소스 중 

    {@link android.content.Context#getFilesDir getFilesDir()} 메서드에 의해 반환된 것에 상응합니다.

    </li>

    <li>

    <code>database</code>. 

    {@link android.content.Context#getDatabasePath getDatabasePath()} 메서드에 의해, 또는 

    {@link android.database.sqlite.SQLiteOpenHelper} 클래스를 사용하여 반환된 데이터베이스에 상응합니다.

    </li>

    <li>

    <code>sharedpref</code>. {@link android.content.Context#getSharedPreferences getSharedPreferences()}

 메서드에 의해 반환된 {@link android.content.SharedPreferences} 객체에

 상응합니다.

    </li>

    <li>

    <code>external</code>. 리소스가 외부 저장소에 있으며, 디렉터리 내의 파일 중 {@link android.content.Context#getExternalFilesDir getExternalFilesDir()} 메서드에 의해 반환된 것에 상응합니다.

    </li>

    <li>

    <code>path</code>. 백업에 포함시키거나 백업에서 배제하고자 하는 리소스로 이어지는 파일 경로입니다.

    </li>

  </ul>

  </li>

</ul>

<h3 id="prohibit">데이터 백업 금지하기</h3>

<p>

  앱 데이터 중 어떤 것이라도 자동 백업을 방지하기로 선택할 수도 있습니다. 매니페스트의 앱 요소에서 <code>android:allowBackup</code> 특성을 <code>false</code>로 설정하면 됩니다.

 이 설정은 다음 예시 코드로 설명해 놓았습니다.

</p>

<pre>

<?xml version="1.0" encoding="utf-8"?>

<manifest xmlns:android="http://schemas.android.com/apk/res/android"

        xmlns:tools="http://schemas.android.com/tools"

        package="com.my.appexample">

    <uses-sdk android:minSdkVersion="MNC"/>

    <uses-sdk android:targetSdkVersion="MNC"/>

    <app ...

<strong>        android:allowBackup="false"&gt;</strong>

    </app>

    ...

</manifest>

</pre>

<h2 id="testing">백업 구성 테스트</h2>

<p>

  백업 구성을 만들었으면 앱이 데이터를 저장하고 제대로 복구되는지 확인하기 위해 테스트해보는 것이 좋습니다.

</p>

<h4>백업 로깅 활성화</h4>

<p>

  백업 기능이 XML 파일을 구문 분석하는 방법을 결정하는 데 도움이 되는 방법으로 테스트 백업을 수행하기 전에 로깅을 활성화하는 방안이 있습니다.

</p>

<pre class="noprettyprint">

$ adb shell setprop log.tag.BackupXmlParserLogging VERBOSE

</pre>

<h4>백업 테스트</h4>

<p>수동으로 백업을 실행하려면, 우선 다음과 같은 명령을 호출하여 백업 관리자를 초기화해야 합니다.

</p>

<pre class="noprettyprint">

$ adb shell bmgr run

</pre>

<p>

  다음으로, 다음과 같은 명령을 사용하여 애플리케이션을 수동으로 백업하되 앱의 패키지 이름을 <code>&lt;PACKAGE&gt;</code> 매개변수로 지정합니다.

</p>

<pre class="noprettyprint">

$ adb shell bmgr fullbackup &lt;PACKAGE&gt;</pre>

<h4>복구 테스트</h4>

<p>

  앱 데이터를 백업한 다음 수동으로 복구를 시작하려면, 다음 명령을 호출하되, 앱에 대한 패키지 이름을 <code>&lt;PACKAGE&gt;</code> 매개변수로 지정하십시오.

</p>

<pre class="noprettyprint">

$ adb shell bmgr restore <PACKAGE>

</pre>

<p class="warning">

  <b>경고:</b> 이 작업을 수행하면 앱이 중지되고 복구 작업을 수행하기 전에 데이터를 지워버립니다.

</p>

<p>

  앱의 복구 프로세스를 시작하려면 앱을 제거했다가 다시 설치하면 됩니다. 앱 데이터는 앱 설치가 완료되면 클라우드에서 자동으로 복원됩니다.

</p>

<h4>백업 문제 해결</h4>

<p>

  문제에 직면하면 백업 데이터와 관련 메타데이터를 지우면 됩니다. 그러려면 <strong>설정 &gt; 백업</strong>에서 백업을 껐다가 켜거나, 기기를 공장 재설정하거나 아니면 다음의 명령을 호출하십시오.

</p>

<pre>$ adb shell bmgr wipe &lt;TRANSPORT&gt; &lt;PACKAGE&gt;</pre>

<p>

  <code>&lt;TRANSPORT&gt;</code> 값이 <code>com.google.android.gms</code>로 접두사가 붙어있어야 합니다.

  전송 목록을 가져오려면 다음과 같은 명령을 호출하면 됩니다.

</p>

<pre>$ adb shell bmgr list transports</pre>

<h2 id="issues">알려진 문제</h2>

<p>다음은 자동 백업 서비스에 대해 알려진 문제입니다.</p>

<ul>

  <li><strong>Google Cloud 메시지</strong> - 푸시 알림에 Google Cloud 메시지를 사용하는 앱의 경우, Google Cloud 메시지 등록에 의해 반환된 등록 ID를 백업하면 복원된 앱에 대한 푸시 알림을 끊게 되는 문제가 알려져 있습니다. 새 기기에 설치된 다음에는 새 등록 ID에 대하여 API를 쿼리하는 것이 중요합니다. 이것은 기존 등록 ID가 백업된 경우는 해당되지 않습니다.

 이 문제를 피하려면 백업된 파일 집합에서 등록 ID를 배제하십시오.

  </li>

</ul>

page.title=앱 링크

page.image=images/cards/card-app-linking_2x.png

page.keywords=applinking, 딥 링크, 인텐트

@jd:body

<div id="qv-wrapper">

  <div id="qv">

    <h2>이 문서의 내용</h2>

      <ol>

        <li><a href="#web-assoc">웹사이트 연관 선언</a></li>

        <li><a href="#verfy-links">앱 링크 확인 요청</a></li>

        <li><a href="#user-manage">앱 링크 설정 관리</a></li>

      </ol>

  </div>

</div>

<p>

  Android 인텐트 시스템은 유연한 메커니즘이라 앱이 콘텐츠와 요청을 처리할 수 있습니다.

  여러 개의 앱이 자신의 인텐트 필터에서 모두 일치하는 URI 패턴을 선언할 수 있습니다. 사용자가 기본 시작 처리자가 없는 웹 링크를 클릭하는 경우 플랫폼이 대화창을 표시하여 해당 사용자가 일치하는 인텐트 필터를 선언한 앱 목록에서 선택 할 수 있습니다.

</p>

<p>

  Android M 개발자 미리 보기에서는 앱 링크에 대한 지원을 도입합니다. 이를 통해 앱 개발자들이 앱을 본인이 소유한 웹 도메인과 연관시켜 기존의 링크 처리를 한 단계 개선합니다.

 개발자가 이 연관 관계를 생성하면 플랫폼이 특정 웹 링크를 처리하는 데 사용된 기본 앱을 알아서 판단하여 사용자에게 물어보는 과정을 건너뛸 수 있습니다.

</p>

<h2 id="web-assoc">웹사이트 연관 선언</h2>

<p>

  웹사이트 소유자가 앱 링크를 설정하려면 앱과의 연관 관계를 선언해야 합니다. 사이트 소유자는 앱에 대한 이러한 관계를 선언하는 데 JSON 파일을 호스팅하는 방식을 씁니다. 일명 {@code statements.json}이라는 파일을 도메인에서 잘 알려진 위치에 선언합니다.

</p>

<pre>http://&lt;domain&gt;:&lt;optional port&gt;/.well-known/statements.json</pre>

<p class="note">

  <strong>참고:</strong>

  M 개발자 미리 보기 기간 중에는 JSON 파일을 http 프로토콜을 통해 확인합니다. 플랫폼이 공식적으로 출시되면 이 파일을 암호화된 https 프로토콜에서 확인하게 됩니다.

</p>

<p>

  이 JSON 파일은 이 도메인 아래에서 URL에 대한 기본 처리자로 사용되어야 하는 Android 앱을 나타냅니다.

 이것이 앱을 식별하는 기반은 다음과 같은 필드입니다.

</p>

<ul>

  <li>{@code package_name}: 앱의 매니페스트에 선언된 패키지 이름입니다.</li>

  <li>{@code sha256_cert_fingerprints}: 앱의 서명 인증서의 SHA256 지문입니다.

    Java keytool을 사용하여 이 지문을 생성하려면 다음과 같은 명령을 사용십시오.

    <pre>keytool -list -v -keystore my-release-key.keystore</pre>

  </li>

</ul>

<p>

  다음 파일 목록은

{@code statements.json} 파일의 콘텐츠와 형식을 예를 들어 나타낸 것입니다.

</p>

<pre>

[{

  "relation": ["delegate_permission/common.handle_all_urls"],

  "target": {

    "namespace": "android_app",

    "package_name": "<strong>&lt;package name&gt;</strong>",

    "sha256_cert_fingerprints": ["<strong>6C:EC:C5:0E:34:AE....EB:0C:9B</strong>"]

  }

}]

</pre>

<h2 id="verfy-links">앱 링크 확인 요청</h2>

<p>

  앱은 플랫폼에 자신의 인텐트 필터의 데이터 요소 내에서 호스트 이름으로 정의된 모든 앱 링크를 자동으로 확인해달라고 요청할 수 있습니다. 이때 비교 대상은 각각의 웹 도메인에서 호스팅된 {@code statements.json} 파일입니다.

 앱 링크 확인을 요청하려면 매니페스트에서 원하는 인텐트 필터 각각에 {@code android:autoVerify}

특성을 하나씩 추가하면 됩니다. 다음 매니페스트 코드 조각에 나타낸 내용을 참고하십시오.

</p>

<pre>

<activity ...>

    &lt;intent-filter <strong>android:autoVerify="true"</strong>&gt;

        <action android:name="android.intent.action.VIEW" />

        <category android:name="android.intent.category.DEFAULT" />

        <category android:name="android.intent.category.BROWSABLE" />

        <data android:scheme="http" android:host="www.android.com" />

        <data android:scheme="https" android:host="www.android.com" />

    </intent-filter>

</activity>

</pre>

<p>

  앱 매니페스트에 {@code android:autoVerify} 특성이 있으면, 플랫폼은 앱이 설치된 시점에 앱 링크를 확인하려 시도합니다.

 플랫폼이 앱 링크를 성공적으로 확인하지 못하면 해당 앱은 웹 링크를 처리하기 위한 기본 설정 앱으로 설정되지 않습니다.

 다음번에 사용자가 그런 링크 중 하나를 열면, 플랫폼은 사용자에게 메시지를 표시하는 방식으로 변경합니다.

</p>

<p class="note">

  <strong>참고:</strong> 테스트 중에는 확인에 실패하고 나서 거짓 긍정 결과가 나올 가능성이 있지만, 사용자가 앱에 물어보지 않고 지원되는 링크를 열도록 명시적으로 활성화해 놓았고 이때 시스템 설정 앱을 사용한 경우, 대화창이 표시되지 않고 링크는 개발자 본인의 앱으로 이동하지만 이는 순전히 사용자 설정 때문이고 확인이 성공해서가 아닙니다.

</p>

<h2 id="user-manage">앱 링크 설정 관리</h2>

<p>

  사용자가 앱 링크 설정을 변경하여 URL을 본인이 선호하는 방식으로 처리하도록 할 수 있습니다. 앱 링크를 검토하고 관리하려면 <strong>설정 &gt; 앱 &gt; 앱 정보 &gt; 기본으로 열기</strong> 아래의 시스템 설정 앱에서 하면 됩니다.

</p>

page.title=Android M 개발자 미리 보기

page.tags="preview",

meta.tags="preview, M preview", androidm

fullpage=true

section.landing=true

header.hide=1

footer.hide=1

@jd:body

<section class="dac-expand dac-hero dac-light" >

  <div class="wrap">

    <div class="cols dac-hero-content">

      <div class="col-9of16 col-push-7of16 dac-hero-figure">

        <img class="dac-hero-image" src="{@docRoot}images/home/devices-hero_620px_2x.png" srcset="{@docRoot}images/home/devices-hero_620px.png 1x,

             {@docRoot}images/home/devices-hero_620px_2x.png 2x">

      </div>

      <div class="col-7of16 col-pull-9of16">

        <h1 class="dac-hero-title">Android M 개발자 미리 보기</h1>

        <p class="dac-hero-description">

          Android의 다음 버전을 만나볼 준비가 되셨습니까? 여러분의 앱을 Nexus 5, 6, 9 및 Player에서 테스트해보십시오.

 새로운 내용은 무엇인지 둘러보십시오. <strong>런타임 권한</strong>, <strong>Doze</strong> 및 <strong>앱 대기 모드</strong> 절전 기능, 새로 나온 <strong>지원 기술</strong>, 이외에도 많은 것이 있습니다.

        </p>

        <a class="dac-hero-cta" href="{@docRoot}preview/overview.html">

          <span class="dac-sprite dac-auto-chevron"></span>

          지금 시작하세요!

</a><br>

      </div>

    </div>

    <div class="dac-section dac-small">

      <div class="resource-widget resource-flow-layout col-16"

           data-query="collection:preview/landing/resources"

           data-cardSizes="6x2"

           data-maxResults="6"></div>

    </div>

  </div>

</section>

<section class="dac-section dac-gray"><div class="wrap">

  <h1 class="dac-section-title">리소스</h1>

  <div class="dac-section-subtitle">

    앱을 Android M에 대비시키는 데 유용한 중요 정보입니다.

  </div>

  <div class="resource-widget resource-flow-layout col-16"

       data-query="collection:preview/landing/more"

       data-cardSizes="6x6"

       data-maxResults="16"></div>

    <ul class="dac-section-links">

      <li class="dac-section-link">

        <a href="https://code.google.com/p/android-developer-preview/">

          <span class="dac-sprite dac-auto-chevron"></span>

          문제 보고

</a>

      </li> 

      <li class="dac-section-link"><a href="http://g.co/dev/AndroidMDevPreview">

        <span class="dac-sprite dac-auto-chevron"></span>

        G+ 커뮤니티 가입

</a>

      </li>

    </ul>

  </div>

</section>