diff options
| author | David Friedman <dmail@google.com> | 2015-10-02 21:20:38 -0700 |
|---|---|---|
| committer | David Friedman <dmail@google.com> | 2015-10-02 21:20:38 -0700 |
| commit | 2762377a48b3e9feae499b8f1884a805d40c487e (patch) | |
| tree | a88194ee7954453f220c3f158b73ea0aadf325c9 /docs/html-intl/intl | |
| parent | 91c19a34e835645abb27c38936659bba2e5f50b0 (diff) | |
Docs: Localization of Android fundamentals
Bug: 20503562
Change-Id: I3ea2cb1108021ef4409b7788dcc22bfefccc074c
Diffstat (limited to 'docs/html-intl/intl')
16 files changed, 793 insertions, 809 deletions
diff --git a/docs/html-intl/intl/in/guide/components/intents-filters.jd b/docs/html-intl/intl/in/guide/components/intents-filters.jd index 9b2eb48fd069..8e89b5db81c7 100644 --- a/docs/html-intl/intl/in/guide/components/intents-filters.jd +++ b/docs/html-intl/intl/in/guide/components/intents-filters.jd @@ -94,7 +94,7 @@ android.content.Context#sendStickyBroadcast sendStickyBroadcast()}.</p> <ul> <li><b>Intent eksplisit</b> menetapkan komponen untuk memulai dengan nama ( nama kelas yang sepenuhnya memenuhi syarat). Anda biasanya akan menggunakan intent eksplisit untuk memulai sebuah komponen -dalam aplikasi sendiri, karena Anda mengetahui nama kelas dari aktivitas atau layanan yang ingin dimulai. +dalam aplikasi sendiri, karena Anda mengetahui nama kelas dari aktivitas atau layanan yang ingin dimulai. Misalnya, mulai aktivitas baru sebagai respons terhadap tindakan pengguna atau mulai layanan untuk mengunduh file di latar belakang.</li> @@ -220,7 +220,7 @@ sebagai awalan. Misalnya:</p> <dt><b>Data</b></dt> <dd>URI (objek {@link android.net.Uri}) yang mengacu data untuk diolah dan/atau -tipe MIME dari data tersebut. Tipe data yang disediakan umumnya didikte oleh tindakan intent. +tipe MIME dari data tersebut. Tipe data yang disediakan umumnya didikte oleh tindakan intent. Misalnya, jika tindakan merupakan {@link android.content.Intent#ACTION_EDIT}, data harus berisi URI dari dokumen untuk diedit. @@ -230,7 +230,7 @@ Misalnya, aktivitas yang mampu menampilkan gambar mungkin tidak mampu memutar file audio, walaupun format URI mungkin serupa. Jadi menetapkan tipe MIME data Anda akan membantu sistem Android menemukan komponen terbaik untuk diterima intent. -Akan tetapi, tipe MIME seringkali bisa diambil dari URI—terutama saat datanya merupakan URI +Akan tetapi, tipe MIME seringkali bisa diambil dari URI—terutama saat datanya merupakan URI {@code content:}, yang menunjukkan data tersebut berada di perangkat dan dikontrol oleh {@link android.content.ContentProvider}, yang membuat data tipe MIME terlihat di sistem.</p> @@ -242,7 +242,7 @@ android.content.Intent#setDataAndType setDataAndType()}.</p> <p class="caution"><strong>Perhatian:</strong> Jika ingin mengatur tipe URI dan MIME, <strong>jangan</strong> panggil {@link android.content.Intent#setData setData()} dan {@link android.content.Intent#setType setType()} karena mereka saling menghapuskan nilai satu sama lain. -Selalu gunakan {@link android.content.Intent#setDataAndType setDataAndType()} untuk mengatur +Selalu gunakan {@link android.content.Intent#setDataAndType setDataAndType()} untuk mengatur tipe URI maupun MIME.</p> </dd> @@ -290,8 +290,8 @@ Anda juga bisa membuat objek {@link android.os.Bundle} dengan semua data ekstra, android.content.Intent#putExtras putExtras()}.</p> <p>Misalnya, saat membuat intent yang akan dikirimkan bersama email -{@link android.content.Intent#ACTION_SEND}, Anda bisa menetapkan penerima "kepada" dengan kunci -{@link android.content.Intent#EXTRA_EMAIL}, dan menetapkan "subjek" dengan kunci +{@link android.content.Intent#ACTION_SEND}, Anda bisa menetapkan penerima "kepada" dengan kunci +{@link android.content.Intent#EXTRA_EMAIL}, dan menetapkan "subjek" dengan kunci {@link android.content.Intent#EXTRA_SUBJECT}.</p> <p>Kelas {@link android.content.Intent} menetapkan beberapa konstanta {@code EXTRA_*} @@ -339,7 +339,7 @@ startService(downloadIntent); objek {@link java.lang.Class} pada komponen. Dengan demikian, intent ini memulai secara eksplisit kelas {@code DownloadService} dalam aplikasi.</p> -<p>Untuk informasi selengkapnya tentang membangun dan memulai layanan, lihat panduan +<p>Untuk informasi selengkapnya tentang membangun dan memulai layanan, lihat panduan <a href="{@docRoot}guide/components/services.html">Layanan</a>.</p> @@ -373,9 +373,7 @@ intent tersebut.</p> Intent sendIntent = new Intent(); sendIntent.setAction(Intent.ACTION_SEND); sendIntent.putExtra(Intent.EXTRA_TEXT, textMessage); -sendIntent.setType({@link - org.apache.http.protocol.HTTP#PLAIN_TEXT_TYPE - HTTP.PLAIN_TEXT_TYPE}); // "text/plain" MIME type +sendIntent.setType("text/plain"); // Verify that the intent will resolve to an activity if (sendIntent.resolveActivity(getPackageManager()) != null) { @@ -544,7 +542,7 @@ lolos melalui salah satu filter komponen mungkin akan lolos di filter lain. Informasi selengkapnya tentang cara sistem menetapkan intent disediakan dalam bagian di bawah ini tentang <a href="#Resolution">Resolusi Intent</a>.</p> -<p class="caution"><strong>Perhatian:</strong> Untuk menghindari menjalankan +<p class="caution"><strong>Perhatian:</strong> Untuk menghindari menjalankan {@link android.app.Service} aplikasi yang berbeda secara tidak sengaja, selalu gunakan intent eksplisit untuk memulai layanan Anda sendiri dan jangan deklarasikan filter intent untuk layanan Anda.</p> @@ -603,7 +601,7 @@ terbuka saat pengguna meluncurkan aplikasi dengan ikon launcher:</p> menunjukkan ini adalah titik masuk utama dan tidak mengharapkan data intent apa pun.</li> <li>Kategori {@link android.content.Intent#CATEGORY_LAUNCHER} menunjukjkan bahwa ikon aktivitas ini harus ditempatkan dalam launcher aplikasi sistem. Jika elemen <a href="{@docRoot}guide/topics/manifest/activity-element.html">{@code <activity>}</a> - tidak menetapkan ikon dengan{@code icon}, maka sistem akan menggunakan ikon dari elemen + tidak menetapkan ikon dengan{@code icon}, maka sistem akan menggunakan ikon dari elemen <a href="{@docRoot}guide/topics/manifest/application-element.html">{@code <application>}</a>.</li> </ul> <p>Keduanya harus dipasangkan bersama agar aktivitas muncul dalam launcher aplikasi.</p> @@ -644,10 +642,10 @@ proses aplikasi Anda sendiri.</p> <li>Mendeklarasikan intent untuk dieksekusi saat pengguna melakukan tindakan dengan <a href="{@docRoot}guide/topics/ui/notifiers/notifications.html">Pemberitahuan</a> ({@link android.app.NotificationManager} sistem Android akan mengeksekusi {@link android.content.Intent}) Anda. - <li>Mendeklarasikan intent untuk dieksekusi saat pengguna melakukan tindakan dengan + <li>Mendeklarasikan intent untuk dieksekusi saat pengguna melakukan tindakan dengan <a href="{@docRoot}guide/topics/appwidgets/index.html">App Widget</a> (aplikasi layar Home mengeksekusi {@link android.content.Intent}). - <li>Mendeklarasikan intent untuk dieksekusi di waktu yang telah ditetapkan di masa mendatang + <li>Mendeklarasikan intent untuk dieksekusi di waktu yang telah ditetapkan di masa mendatang ({@link android.app.AlarmManager} sistem Android akan mengeksekusi {@link android.content.Intent}). </ul> @@ -672,7 +670,7 @@ startActivity()}. Anda harus mendeklarasikan tipe komponen yang dimaksud saat me metode di atas untuk membuat {@link android.app.PendingIntent} menjadi satu-satunya metode {@link android.app.PendingIntent} yang mungkin Anda butuhkan.</p> -<p>Tiap metode mengambil {@link android.content.Context} aplikasi saat itu, +<p>Tiap metode mengambil {@link android.content.Context} aplikasi saat itu, {@link android.content.Intent} yang ingin Anda bungkus, dan satu atau beberapa flag yang menetapkan cara penggunaan intent (misalnya apakah intent bisa digunakan lebih dari sekali).</p> @@ -747,7 +745,7 @@ mendeklarasikan kategori lebih banyak daripada yang ditetapkan dalam {@link andr selalu lolos pengujian ini, kategori apa pun yang dideklarasikan dalam filter.</p> <p class="note"><strong>Catatan:</strong> -Android secara otomatis menerapkan kategori {@link android.content.Intent#CATEGORY_DEFAULT} +Android secara otomatis menerapkan kategori {@link android.content.Intent#CATEGORY_DEFAULT} untuk semua intent implisit yang diteruskan ke {@link android.content.Context#startActivity startActivity()} dan {@link android.app.Activity#startActivityForResult startActivityForResult()}. @@ -819,14 +817,14 @@ dan tipe MIME yang ditetapkan dalam filter. Aturannya adalah sebagai berikut: <li>Intent yang tidak berisi URI maupun tipe MIME hanya akan lolos pengujian jika filter tersebut tidak menetapkan URI atau tipe MIME apa pun.</li> -<li>Intent yang berisi URI namun tidak berisi tipe MIME (baik secara eksplisit maupun tidak langsung dari +<li>Intent yang berisi URI namun tidak berisi tipe MIME (baik secara eksplisit maupun tidak langsung dari URI) hanya akan lolos pengujian jika URI-nya cocok dengan format URI filter dan filternya juga tidak menetapkan tipe MIME.</li> <li>Intent yang berisi tipe MIME namun tidak berisi URI hanya akan lolos pengujian jika filter mencantumkan tipe MIME yang sama dan tidak menetapkan format URI.</li> -<li>Intent yang berisi URI maupun tipe MIME (baik secara eksplisit maupun tidak langsung dari +<li>Intent yang berisi URI maupun tipe MIME (baik secara eksplisit maupun tidak langsung dari URI) hanya akan lolos pengujian bagian tipe MIME jika tipe tersebut cocok dengan tipe yang dicantumkan dalam filter. Ini akan lolos pengujian bagian URI jika URI-nya cocok dengan URI dalam filter atau memiliki {@code content:} @@ -840,7 +838,7 @@ Aturan terakhir ini, aturan (d), mencerminkan harapan bahwa komponen mampu mendapatkan data lokal dari file atau penyedia konten. Oleh karena itu, filter mereka mencatumkan tipe data saja dan tidak secara eksplisit harus menamai skema {@code content:} dan {@code file:}. -Ini adalah kasus umum. Elemen <a href="{@docRoot}guide/topics/manifest/data-element.html">{@code <data>}</a> +Ini adalah kasus umum. Elemen <a href="{@docRoot}guide/topics/manifest/data-element.html">{@code <data>}</a> seperti berikut ini, misalnya, memberi tahu Android bahwa komponen bisa mengambil data gambar dari penyedia konten dan menampilkannya: </p> @@ -876,7 +874,7 @@ komponen bisa mengambil data video dari jaringan untuk melakukan tindakan: <p>Intent dicocokkan dengan filter intent selain untuk menemukan komponen target yang akan diaktifkan, juga untuk menemukan sesuatu tentang rangkaian komponen pada perangkat. Misalnya, aplikasi Home akan menempatkan launcher aplikasi -dengan mencari semua aktivitas dengan filter intent yang menetapkan tindakan +dengan mencari semua aktivitas dengan filter intent yang menetapkan tindakan {@link android.content.Intent#ACTION_MAIN} dan kategori {@link android.content.Intent#CATEGORY_LAUNCHER}.</p> diff --git a/docs/html-intl/intl/in/guide/topics/providers/contacts-provider.jd b/docs/html-intl/intl/in/guide/topics/providers/contacts-provider.jd index 28652fd7c998..994c56b5300b 100644 --- a/docs/html-intl/intl/in/guide/topics/providers/contacts-provider.jd +++ b/docs/html-intl/intl/in/guide/topics/providers/contacts-provider.jd @@ -57,7 +57,7 @@ page.title=Penyedia Kontak <li>{@link android.provider.ContactsContract.Contacts}</li> <li>{@link android.provider.ContactsContract.RawContacts}</li> <li>{@link android.provider.ContactsContract.Data}</li> - <li>{@link android.provider.ContactsContract.StreamItems}</li> + <li>{@code android.provider.ContactsContract.StreamItems}</li> </ol> <h2>Contoh-Contoh Terkait</h2> <ol> @@ -170,7 +170,7 @@ page.title=Penyedia Kontak tabel {@link android.provider.ContactsContract.RawContacts}. Sebagai gantinya, data tersebut disimpan dalam satu atau beberapa baris dalam tabel {@link android.provider.ContactsContract.Data}. Setiap baris data memiliki kolom {@link android.provider.ContactsContract.DataColumns#RAW_CONTACT_ID Data.RAW_CONTACT_ID} yang - berisi nilai {@link android.provider.BaseColumns#_ID RawContacts._ID} dari + berisi nilai {@code android.provider.BaseColumns#_ID RawContacts._ID} dari baris {@link android.provider.ContactsContract.RawContacts} induknya. </p> <h3 id="RawContactsColumns">Kolom-kolom kontak mentah yang penting</h3> @@ -195,7 +195,7 @@ page.title=Penyedia Kontak Nama akun untuk tipe akun yang merupakan sumber kontak mentah ini. Misalnya, nama akun dari akun Google adalah salah satu alamat Gmail pemilik perangkat. Lihat entri berikutnya untuk - {@link android.provider.ContactsContract.SyncColumns#ACCOUNT_TYPE} untuk informasi + {@link android.provider.ContactsContract.SyncColumns#ACCOUNT_TYPE} untuk informasi selengkapnya. </td> <td> @@ -346,12 +346,12 @@ page.title=Penyedia Kontak {@link android.provider.ContactsContract.DataColumns#IS_PRIMARY} </dt> <dd> - Jika tipe baris data ini bisa terjadi lebih dari satu kali untuk suatu kontak mentah, + Jika tipe baris data ini bisa terjadi lebih dari satu kali untuk suatu kontak mentah, kolom {@link android.provider.ContactsContract.DataColumns#IS_PRIMARY} menandai baris data yang berisi data utama untuk tipe itu. Misalnya, jika pengguna menekan lama sebuah nomor telepon untuk kontak dan memilih <strong>Set default</strong>, maka baris {@link android.provider.ContactsContract.Data} yang berisi angka itu - mengatur kolom {@link android.provider.ContactsContract.DataColumns#IS_PRIMARY}-nya ke suatu + mengatur kolom {@link android.provider.ContactsContract.DataColumns#IS_PRIMARY}-nya ke suatu nilai bukan nol. </dd> </dl> @@ -482,16 +482,16 @@ page.title=Penyedia Kontak </p> <p> Tabel {@link android.provider.ContactsContract.Contacts} juga memiliki kolom - {@link android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} yang merupakan + {@code android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} yang merupakan tautan "permanen" ke baris kontak. Karena memelihara kontak - secara otomatis, Penyedia Kontak bisa mengubah nilai {@link android.provider.BaseColumns#_ID} baris kontak + secara otomatis, Penyedia Kontak bisa mengubah nilai {@code android.provider.BaseColumns#_ID} baris kontak untuk merespons agregasi atau sinkronisasi. Sekalipun ini terjadi, URI konten {@link android.provider.ContactsContract.Contacts#CONTENT_LOOKUP_URI} yang dikombinasikan dengan - {@link android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} kontak akan tetap + {@code android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} kontak akan tetap menunjuk ke baris kontak itu, sehingga Anda bisa menggunakan - {@link android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} + {@code android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} untuk memelihara tautan ke kontak "favorit", dan seterusnya. Kolom ini memiliki formatnya sendiri, yang - tidak terkait dengan format kolom {@link android.provider.BaseColumns#_ID}. + tidak terkait dengan format kolom {@code android.provider.BaseColumns#_ID}. </p> <p> Gambar 3 menampilkan cara ketiga tabel utama terkait satu sama lain. @@ -601,13 +601,13 @@ page.title=Penyedia Kontak Akses ke profil pengguna memerlukan izin khusus. Selain itu, izin {@link android.Manifest.permission#READ_CONTACTS} dan {@link android.Manifest.permission#WRITE_CONTACTS} diperlukan untuk membaca dan menulis, akses - ke profil pengguna memerlukan masing-masing izin {@link android.Manifest.permission#READ_PROFILE} dan - {@link android.Manifest.permission#WRITE_PROFILE} untuk akses baca dan tulis. + ke profil pengguna memerlukan masing-masing izin {@code android.Manifest.permission#READ_PROFILE} dan + {@code android.Manifest.permission#WRITE_PROFILE} untuk akses baca dan tulis. </p> <p> Ingatlah bahwa Anda harus mempertimbangkan profil pengguna bersifat sensitif. Izin - {@link android.Manifest.permission#READ_PROFILE} memungkinkan Anda mengakses data yang mengidentifikasi secara pribadi + {@code android.Manifest.permission#READ_PROFILE} memungkinkan Anda mengakses data yang mengidentifikasi secara pribadi pengguna perangkat. Pastikan memberi tahu pengguna alasan Anda memerlukan izin akses profil pengguna dalam keterangan aplikasi Anda. </p> @@ -648,7 +648,7 @@ mProfileCursor = <p> Penyedia Kontak mengelola data yang mencatat status data kontak dalam repository. Metadata repository ini disimpan di berbagai tempat, termasuk baris-baris tabel - Raw Contacts, Data, dan Contacts, + Raw Contacts, Data, dan Contacts, tabel {@link android.provider.ContactsContract.Settings}, dan tabel {@link android.provider.ContactsContract.SyncState}. Tabel berikut menampilkan efek setiap potongan metadata ini: @@ -825,7 +825,7 @@ mProfileCursor = Entitas adalah seperti tabel yang terdiri atas kolom-kolom terpilih dari tabel induk dan tabel anaknya. Bila membuat query sebuah entitas, Anda memberikan proyeksi dan kriteria pencarian berdasarkan kolom-kolom yang tersedia dari entitas itu. Hasilnya adalah sebuah {@link android.database.Cursor} yang - berisi satu baris untuk setiap baris tabel anak yang diambil. Misalnya, jika Anda membuat query + berisi satu baris untuk setiap baris tabel anak yang diambil. Misalnya, jika Anda membuat query {@link android.provider.ContactsContract.Contacts.Entity} untuk satu nama kontak dan semua baris {@link android.provider.ContactsContract.CommonDataKinds.Email} untuk semua kontak mentah bagi nama itu, Anda akan mendapatkan kembali {@link android.database.Cursor} berisi satu baris @@ -921,7 +921,7 @@ public Loader<Cursor> onCreateLoader(int id, Bundle args) { } </pre> <p> - Bila selesai dimuat, {@link android.app.LoaderManager} akan memicu callback ke + Bila selesai dimuat, {@link android.app.LoaderManager} akan memicu callback ke {@link android.app.LoaderManager.LoaderCallbacks#onLoadFinished(Loader, D) onLoadFinished()}. Salah satu argumen masuk pada metode ini adalah {@link android.database.Cursor} bersama hasil query. Dalam aplikasi Anda sendiri, Anda bisa memperoleh @@ -978,7 +978,7 @@ public Loader<Cursor> onCreateLoader(int id, Bundle args) { Saat Anda menyisipkan baris kontak mentah baru dan baris data terkaitnya sebagai satu set objek {@link android.content.ContentProviderOperation}, Anda harus menautkan baris data ke baris kontak mentah dengan memasukkan nilai - {@link android.provider.BaseColumns#_ID} kontak mentah sebagai + {@code android.provider.BaseColumns#_ID} kontak mentah sebagai nilai {@link android.provider.ContactsContract.DataColumns#RAW_CONTACT_ID}. Akan tetapi, nilai ini tidak tersedia saat Anda membuat {@link android.content.ContentProviderOperation} untuk baris data, karena Anda belum menerapkan @@ -1011,7 +1011,7 @@ public Loader<Cursor> onCreateLoader(int id, Bundle args) { larik hasil antara. Nilai <code>previousResult</code> adalah indeks dari salah satu hasil ini, yang diambil dan disimpan bersama nilai <code>key</code>. Cara ini memungkinkan Anda menyisipkan record kontak mentah baru dan mendapatkan kembali nilai - {@link android.provider.BaseColumns#_ID}-nya, lalu membuat "acuan balik" ke + {@code android.provider.BaseColumns#_ID}-nya, lalu membuat "acuan balik" ke nilai itu saat Anda menambahkan baris {@link android.provider.ContactsContract.Data}. <p> Seluruh larik hasil dibuat saat Anda memanggil @@ -1091,7 +1091,7 @@ protected void createContactEntry() { untuk mendapatkan {@link android.provider.ContactsContract.DataColumns#RAW_CONTACT_ID}. Acuan menunjuk balik ke objek {@link android.content.ContentProviderResult} dari operasi pertama, - yang menambahkan baris kontak mentah dan mengembalikan nilai {@link android.provider.BaseColumns#_ID} + yang menambahkan baris kontak mentah dan mengembalikan nilai {@code android.provider.BaseColumns#_ID} barunya. Hasilnya, setiap data ditautkan secara otomatis oleh {@link android.provider.ContactsContract.DataColumns#RAW_CONTACT_ID}-nya ke baris {@link android.provider.ContactsContract.RawContacts} baru yang memilikinya. @@ -1227,11 +1227,11 @@ protected void createContactEntry() { </li> <li> Buat sebuah objek {@link android.content.ContentProviderOperation.Builder} yang cocok untuk - memberlakukan batasan, dengan menggunakan metode + memberlakukan batasan, dengan menggunakan metode {@link android.content.ContentProviderOperation#newAssertQuery(Uri)}. Untuk URI konten, gunakan {@link android.provider.ContactsContract.RawContacts#CONTENT_URI RawContacts.CONTENT_URI} - dengan {@link android.provider.BaseColumns#_ID} kontak mentah yang ditambahkan padanya. + dengan {@code android.provider.BaseColumns#_ID} kontak mentah yang ditambahkan padanya. </li> <li> Untuk objek {@link android.content.ContentProviderOperation.Builder}, panggil @@ -1240,7 +1240,7 @@ protected void createContactEntry() { dengan nomor versi yang baru saja Anda ambil. </li> <li> - Untuk {@link android.content.ContentProviderOperation.Builder} yang sama, panggil + Untuk {@link android.content.ContentProviderOperation.Builder} yang sama, panggil {@link android.content.ContentProviderOperation.Builder#withExpectedCount(int) withExpectedCount()} untuk memastikan bahwa hanya satu baris yang diuji oleh pernyataan ini. </li> @@ -1387,7 +1387,7 @@ StructuredPostal.CONTENT_URI}, {@link android.app.Activity#startActivityForResult(Intent, int) startActivityForResult()}, yang menghasilkan URI konten dari baris terpilih. Bentuk URI adalah URI konten tabel dengan <code>LOOKUP_ID</code> baris yang ditambahkan padanya. - Aplikasi kontak perangkat mendelegasikan izin membaca dan menulis untuk URI konten ini + Aplikasi kontak perangkat mendelegasikan izin membaca dan menulis untuk URI konten ini selama masa pakai aktivitas Anda. Lihat panduan <a href="{@docRoot}guide/topics/providers/content-provider-basics.html"> Dasar-Dasar Penyedia Konten</a> untuk detail selengkapnya. @@ -1408,7 +1408,7 @@ StructuredPostal.CONTENT_URI}, {@link android.app.Activity#startActivityForResult(Intent, int) startActivityForResult()}, URI konten dari kontak mentah yang baru saja ditambahkan akan dikembalikan ke {@link android.app.Activity#onActivityResult(int, int, Intent) onActivityResult()} - metode callback aktivitas Anda pada argumen {@link android.content.Intent}, di + metode callback aktivitas Anda pada argumen {@link android.content.Intent}, di bidang "data". Untuk mendapatkan nilainya, panggil {@link android.content.Intent#getData()}. </td> </tr> @@ -1659,7 +1659,7 @@ startActivity(insertIntent); <p> Anda mengimplementasikan adaptor sinkronisasi sebagai subkelas {@link android.content.AbstractThreadedSyncAdapter} dan menginstalnya sebagai bagian dari aplikasi - Android. Sistem akan mempelajari adaptor sinkronisasi dari elemen-elemen di manifes + Android. Sistem akan mempelajari adaptor sinkronisasi dari elemen-elemen di manifes aplikasi Anda dan dari file XML khusus yang ditunjuk oleh manifes. File XML mendefinisikan tipe akun untuk layanan online dan otoritas untuk penyedia konten, yang bersama-sama mengidentifikasi adaptor secara unik. Adaptor sinkronisasi tidak menjadi aktif hingga pengguna menambahkan @@ -1696,7 +1696,7 @@ startActivity(insertIntent); </ol> <p> Jika layanan menerima kredensial, autentikator bisa - menyimpan kredensial itu untuk digunakan nanti. Karena kerangka kerja autentikator plug-in, + menyimpan kredensial itu untuk digunakan nanti. Karena kerangka kerja autentikator plug-in, {@link android.accounts.AccountManager} bisa menyediakan akses ke setiap token autentikasi yang didukung suatu autentikator dan dipilihnya untuk diekspos, seperti token autentikasi OAuth2. </p> @@ -1757,9 +1757,9 @@ startActivity(insertIntent); </dt> <dd> {@link android.accounts.AccountManager} memulai layanan ini untuk memulai proses - autentikasi. Metode {@link android.app.Service#onCreate()} layanan membuat instance + autentikasi. Metode {@link android.app.Service#onCreate()} layanan membuat instance objek autentikator. Bila sistem ingin mengautentikasi akun pengguna untuk - adaptor sinkronisasi aplikasi, sistem akan memanggil metode + adaptor sinkronisasi aplikasi, sistem akan memanggil metode {@link android.app.Service#onBind(Intent) onBind()} layanan guna mendapatkan {@link android.os.IBinder} bagi autentikator. Hal ini memungkinkan sistem melakukan panggilan lintas proses ke metode autentikator. @@ -1801,7 +1801,7 @@ elemen anak yang menyediakan data tertentu ke <li> Elemen <code><<a href="{@docRoot}guide/topics/manifest/meta-data-element.html">meta-data</a>></code> - untuk layanan adaptor sinkronisasi menunjuk ke + untuk layanan adaptor sinkronisasi menunjuk ke file XML <code>res/xml/syncadapter.xml</code>. Pada gilirannya, file ini mendefinisikan URI untuk layanan web yang akan disinkronkan dengan Penyedia Kontak, dan tipe akun untuk layanan web. @@ -1821,8 +1821,8 @@ elemen anak yang menyediakan data tertentu ke </dl> <h2 id="SocialStream">Data Aliran Sosial</h2> <p> - Tabel-tabel {@link android.provider.ContactsContract.StreamItems} dan - {@link android.provider.ContactsContract.StreamItemPhotos} + Tabel-tabel {@code android.provider.ContactsContract.StreamItems} dan + {@code android.provider.ContactsContract.StreamItemPhotos} mengelola data yang masuk dari jaringan sosial. Anda bisa menulis adaptor sinkronisasi yang menambahkan data aliran dari jaringan Anda sendiri ke tabel-tabel ini, atau Anda bisa membaca data aliran dari tabel-tabel ini dan menampilkannya dalam aplikasi sendiri, atau keduanya. Dengan fitur-fitur ini, layanan dan aplikasi @@ -1830,8 +1830,8 @@ elemen anak yang menyediakan data tertentu ke </p> <h3 id="StreamText">Teks aliran sosial</h3> <p> - Item aliran selalu dikaitkan dengan kontak mentah. - {@link android.provider.ContactsContract.StreamItemsColumns#RAW_CONTACT_ID} menautkan ke + Item aliran selalu dikaitkan dengan kontak mentah. + {@code android.provider.ContactsContract.StreamItemsColumns#RAW_CONTACT_ID} menautkan ke nilai <code>_ID</code> untuk kontak mentah. Tipe akun dan nama akun kontak mentah juga disimpan dalam baris item aliran. </p> @@ -1840,14 +1840,14 @@ elemen anak yang menyediakan data tertentu ke </p> <dl> <dt> - {@link android.provider.ContactsContract.StreamItemsColumns#ACCOUNT_TYPE} + {@code android.provider.ContactsContract.StreamItemsColumns#ACCOUNT_TYPE} </dt> <dd> <strong>Diperlukan.</strong> Tipe akun pengguna untuk kontak mentah yang dikaitkan dengan item aliran ini. Ingatlah untuk mengatur nilai ini saat Anda menyisipkan item aliran. </dd> <dt> - {@link android.provider.ContactsContract.StreamItemsColumns#ACCOUNT_NAME} + {@code android.provider.ContactsContract.StreamItemsColumns#ACCOUNT_NAME} </dt> <dd> <strong>Diperlukan.</strong> Nama akun pengguna untuk kontak mentah yang dikaitkan dengan @@ -1861,30 +1861,30 @@ elemen anak yang menyediakan data tertentu ke menyisipkan item aliran: <ul> <li> - {@link android.provider.ContactsContract.StreamItemsColumns#CONTACT_ID}: - Nilai {@link android.provider.BaseColumns#_ID} kontak yang dikaitkan dengan item aliran + {@code android.provider.ContactsContract.StreamItemsColumns#CONTACT_ID}: + Nilai {@code android.provider.BaseColumns#_ID} kontak yang dikaitkan dengan item aliran ini. </li> <li> - {@link android.provider.ContactsContract.StreamItemsColumns#CONTACT_LOOKUP_KEY}: - Nilai {@link android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} + {@code android.provider.ContactsContract.StreamItemsColumns#CONTACT_LOOKUP_KEY}: + Nilai {@code android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} kontak yang dikaitkan dengan item aliran ini. </li> <li> - {@link android.provider.ContactsContract.StreamItemsColumns#RAW_CONTACT_ID}: - Nilai {@link android.provider.BaseColumns#_ID} kontak mentah yang dikaitkan dengan item aliran + {@code android.provider.ContactsContract.StreamItemsColumns#RAW_CONTACT_ID}: + Nilai {@code android.provider.BaseColumns#_ID} kontak mentah yang dikaitkan dengan item aliran ini. </li> </ul> </dd> <dt> - {@link android.provider.ContactsContract.StreamItemsColumns#COMMENTS} + {@code android.provider.ContactsContract.StreamItemsColumns#COMMENTS} </dt> <dd> Opsional. Menyimpan informasi rangkuman yang bisa Anda tampilkan di awal item aliran. </dd> <dt> - {@link android.provider.ContactsContract.StreamItemsColumns#TEXT} + {@code android.provider.ContactsContract.StreamItemsColumns#TEXT} </dt> <dd> Teks item aliran, baik konten yang diposting oleh sumber item, @@ -1894,7 +1894,7 @@ elemen anak yang menyediakan data tertentu ke menghapus konten yang panjang, tetapi penyedia akan mencoba menghindari memutus tag. </dd> <dt> - {@link android.provider.ContactsContract.StreamItemsColumns#TIMESTAMP} + {@code android.provider.ContactsContract.StreamItemsColumns#TIMESTAMP} </dt> <dd> String teks berisi waktu item aliran yang disisipkan atau diperbarui, berupa @@ -1905,42 +1905,42 @@ elemen anak yang menyediakan data tertentu ke </dl> <p> Untuk menampilkan informasi pengidentifikasi item aliran Anda, gunakan - {@link android.provider.ContactsContract.StreamItemsColumns#RES_ICON}, - {@link android.provider.ContactsContract.StreamItemsColumns#RES_LABEL}, dan - {@link android.provider.ContactsContract.StreamItemsColumns#RES_PACKAGE} untuk menautkan ke sumber daya + {@code android.provider.ContactsContract.StreamItemsColumns#RES_ICON}, + {@code android.provider.ContactsContract.StreamItemsColumns#RES_LABEL}, dan + {@code android.provider.ContactsContract.StreamItemsColumns#RES_PACKAGE} untuk menautkan ke sumber daya dalam aplikasi Anda. </p> <p> - Tabel {@link android.provider.ContactsContract.StreamItems} juga berisi kolom-kolom - {@link android.provider.ContactsContract.StreamItemsColumns#SYNC1} hingga - {@link android.provider.ContactsContract.StreamItemsColumns#SYNC4} untuk penggunaan eksklusif oleh + Tabel {@code android.provider.ContactsContract.StreamItems} juga berisi kolom-kolom + {@code android.provider.ContactsContract.StreamItemsColumns#SYNC1} hingga + {@code android.provider.ContactsContract.StreamItemsColumns#SYNC4} untuk penggunaan eksklusif oleh adaptor sinkronisasi. </p> <h3 id="StreamPhotos">Foto aliran sosial</h3> <p> - Tabel {@link android.provider.ContactsContract.StreamItemPhotos} menyimpan foto-foto yang dikaitkan - dengan item aliran. Kolom -{@link android.provider.ContactsContract.StreamItemPhotosColumns#STREAM_ITEM_ID} tabel ini - menautkan ke nilai dalam kolom {@link android.provider.BaseColumns#_ID} - tabel {@link android.provider.ContactsContract.StreamItems}. Acuan foto disimpan dalam + Tabel {@code android.provider.ContactsContract.StreamItemPhotos} menyimpan foto-foto yang dikaitkan + dengan item aliran. Kolom +{@code android.provider.ContactsContract.StreamItemPhotosColumns#STREAM_ITEM_ID} tabel ini + menautkan ke nilai dalam kolom {@code android.provider.BaseColumns#_ID} + tabel {@code android.provider.ContactsContract.StreamItems}. Acuan foto disimpan dalam tabel pada kolom-kolom ini: </p> <dl> <dt> - Kolom {@link android.provider.ContactsContract.StreamItemPhotos#PHOTO} (BLOB). + Kolom {@code android.provider.ContactsContract.StreamItemPhotos#PHOTO} (BLOB). </dt> <dd> Representasi biner foto, yang diubah ukurannya oleh penyedia untuk penyimpanan dan tampilan. Kolom ini tersedia untuk kompatibilitas ke belakang dengan versi Penyedia Kontak sebelumnya yang menggunakannya untuk menyimpan foto. Akan tetapi, pada versi saat ini Anda tidak boleh menggunakan kolom ini untuk menyimpan foto. Sebagai gantinya, gunakan - {@link android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_FILE_ID} atau - {@link android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_URI} (keduanya + {@code android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_FILE_ID} atau + {@code android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_URI} (keduanya dijelaskan dalam poin-poin berikut) untuk menyimpan foto di file. Kolom ini sekarang berisi thumbnail foto, yang tersedia untuk dibaca. </dd> <dt> - {@link android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_FILE_ID} + {@code android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_FILE_ID} </dt> <dd> Identifier numerik foto untuk kontak mentah. Tambahkan nilai ini ke konstanta @@ -1950,7 +1950,7 @@ elemen anak yang menyediakan data tertentu ke openAssetFileDescriptor()} untuk mendapatkan handle ke file foto. </dd> <dt> - {@link android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_URI} + {@code android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_URI} </dt> <dd> URI konten menunjuk langsung ke file foto untuk foto yang diwakili oleh baris ini. @@ -1965,27 +1965,27 @@ elemen anak yang menyediakan data tertentu ke <ul> <li> Tabel-tabel ini memerlukan izin akses tambahan. Untuk membaca dari tabel, aplikasi Anda - harus memiliki izin {@link android.Manifest.permission#READ_SOCIAL_STREAM}. Untuk memodifikasi + harus memiliki izin {@code android.Manifest.permission#READ_SOCIAL_STREAM}. Untuk memodifikasi tabel, aplikasi Anda harus memiliki izin - {@link android.Manifest.permission#WRITE_SOCIAL_STREAM}. + {@code android.Manifest.permission#WRITE_SOCIAL_STREAM}. </li> <li> - Untuk tabel {@link android.provider.ContactsContract.StreamItems}, jumlah baris + Untuk tabel {@code android.provider.ContactsContract.StreamItems}, jumlah baris yang disimpan bagi setiap kontak mentah adalah terbatas. Setelah batasnya tercapai, Penyedia Kontak akan membuat ruang untuk baris item aliran baru dengan menghapus secara otomatis baris yang memiliki - {@link android.provider.ContactsContract.StreamItemsColumns#TIMESTAMP} terlama. Untuk mendapatkan + {@code android.provider.ContactsContract.StreamItemsColumns#TIMESTAMP} terlama. Untuk mendapatkan batas, keluarkan query ke URI konten - {@link android.provider.ContactsContract.StreamItems#CONTENT_LIMIT_URI}. Anda bisa membiarkan + {@code android.provider.ContactsContract.StreamItems#CONTENT_LIMIT_URI}. Anda bisa membiarkan semua argumen selain URI konten diatur ke <code>null</code>. Query menghasilkan sebuah Kursor yang berisi baris tunggal, dengan kolom tunggal - {@link android.provider.ContactsContract.StreamItems#MAX_ITEMS}. + {@code android.provider.ContactsContract.StreamItems#MAX_ITEMS}. </li> </ul> <p> - Kelas {@link android.provider.ContactsContract.StreamItems.StreamItemPhotos} mendefinisikan - subtabel {@link android.provider.ContactsContract.StreamItemPhotos} yang berisi + Kelas {@code android.provider.ContactsContract.StreamItems.StreamItemPhotos} mendefinisikan + subtabel {@code android.provider.ContactsContract.StreamItemPhotos} yang berisi baris foto untuk satu item aliran. </p> <h3 id="SocialStreamInteraction">Interaksi aliran sosial</h3> @@ -1998,8 +1998,8 @@ elemen anak yang menyediakan data tertentu ke <li> Dengan menyinkronkan layanan jaringan sosial ke Penyedia Kontak dengan adaptor sinkronisasi, Anda bisa mengambil aktivitas terbaru untuk kontak pengguna dan menyimpannya dalam tabel-tabel - {@link android.provider.ContactsContract.StreamItems} dan - {@link android.provider.ContactsContract.StreamItemPhotos} untuk digunakan nanti. + {@code android.provider.ContactsContract.StreamItems} dan + {@code android.provider.ContactsContract.StreamItemPhotos} untuk digunakan nanti. </li> <li> Selain sinkronisasi rutin, Anda bisa memicu adaptor sinkronisasi agar mengambil @@ -2192,7 +2192,7 @@ elemen anak yang menyediakan data tertentu ke pemberitahuan saat pengguna menampilkan kontak. Pemberitahuan ini dikirimkan oleh aplikasi kontak perangkat; hal ini memungkinkan aplikasi Anda menunda operasi yang banyak memproses data hingga dibutuhkan. Misalnya, aplikasi Anda bisa merespons pemberitahuan ini - dengan membaca dalam dan menampilkan foto resolusi tinggi kontak dan item aliran sosial + dengan membaca dalam dan menampilkan foto resolusi tinggi kontak dan item aliran sosial terbaru. Fitur ini dijelaskan lebih detail di bagian <a href="#SocialStreamInteraction">Interaksi aliran sosial</a>. Anda bisa melihat contoh layanan pemberitahuan dalam file <code>NotifierService.java</code> dalam contoh aplikasi @@ -2269,13 +2269,13 @@ elemen anak yang menyediakan data tertentu ke <dt>{@code android:mimeType}</dt> <dd> Tipe MIME custom yang telah Anda definisikan untuk salah satu tipe baris data custom dalam - tabel {@link android.provider.ContactsContract.Data}. Misalnya, nilai + tabel {@link android.provider.ContactsContract.Data}. Misalnya, nilai <code>vnd.android.cursor.item/vnd.example.locationstatus</code> bisa berupa tipe MIME custom untuk baris data yang mencatat lokasi kontak yang terakhir diketahui. </dd> <dt>{@code android:icon}</dt> <dd> - + <a href="{@docRoot}guide/topics/resources/drawable-resource.html">Sumber daya drawable</a> Android yang ditampilkan aplikasi kontak di samping data Anda. Gunakan ini untuk menunjukkan kepada pengguna bahwa data berasal dari layanan Anda. @@ -2330,7 +2330,7 @@ elemen anak yang menyediakan data tertentu ke {@link android.provider.ContactsContract.CommonDataKinds.Photo#CONTENT_ITEM_TYPE Photo.CONTENT_ITEM_TYPE}. Kolom {@link android.provider.ContactsContract.RawContactsColumns#CONTACT_ID} baris yang ditautkan ke - kolom {@link android.provider.BaseColumns#_ID} kontak mentah yang memiliki kolom itu. + kolom {@code android.provider.BaseColumns#_ID} kontak mentah yang memiliki kolom itu. Kelas {@link android.provider.ContactsContract.Contacts.Photo} mendefinisikan subtabel {@link android.provider.ContactsContract.Contacts} yang berisi informasi foto untuk foto utama kontak, yang merupakan foto utama dari kontak mentah utama kontak itu. Demikian pula, @@ -2344,13 +2344,13 @@ elemen anak yang menyediakan data tertentu ke pengambilan informasi foto. Tidak ada kelas praktis untuk mengambil thumbnail utama kontak mentah, tetapi Anda bisa mengirim query ke tabel {@link android.provider.ContactsContract.Data}, dengan memilih - {@link android.provider.BaseColumns#_ID} kontak mentah, + {@code android.provider.BaseColumns#_ID} kontak mentah, {@link android.provider.ContactsContract.CommonDataKinds.Photo#CONTENT_ITEM_TYPE Photo.CONTENT_ITEM_TYPE}, dan kolom {@link android.provider.ContactsContract.Data#IS_PRIMARY} untuk menemukan baris foto utama kontak mentah. </p> <p> Data aliran sosial untuk seseorang bisa juga disertai foto. Data ini disimpan dalam - tabel {@link android.provider.ContactsContract.StreamItemPhotos}, yang dijelaskan lebih detail + tabel {@code android.provider.ContactsContract.StreamItemPhotos}, yang dijelaskan lebih detail di bagian <a href="#StreamPhotos">Foto aliran sosial</a>. </p> diff --git a/docs/html-intl/intl/ja/guide/components/intents-filters.jd b/docs/html-intl/intl/ja/guide/components/intents-filters.jd index b5d49f1b7cae..fe78eca74f24 100644 --- a/docs/html-intl/intl/ja/guide/components/intents-filters.jd +++ b/docs/html-intl/intl/ja/guide/components/intents-filters.jd @@ -49,7 +49,7 @@ page.tags="IntentFilter" </p> <ul> -<li><b>アクティビティを開始するには:</b> +<li><b>アクティビティを開始するには:</b> <p>{@link android.app.Activity} はアプリ内の 1 つの画面を表します。{@link android.app.Activity} の新しいインスタンスを開始するには、{@link android.content.Intent} を {@link android.content.Context#startActivity startActivity()} に渡します。 {@link android.content.Intent} は、開始するアクティビティを記述し、必要なデータすべてを含んでいます。 @@ -62,7 +62,7 @@ android.app.Activity#onActivityResult onActivityResult()} コールバック内 </p></li> -<li><b>サービスを開始するには:</b> +<li><b>サービスを開始するには:</b> <p>{@link android.app.Service} は、ユーザー インターフェースを持たず、バックグラウンドで操作を実行するコンポーネントです。 サービスを開始して 1 回限りの操作を実行する（ファイルのダウンロードなど）には、{@link android.content.Intent} を {@link android.content.Context#startService startService()} に渡します。 @@ -73,7 +73,7 @@ android.app.Activity#onActivityResult onActivityResult()} コールバック内 android.content.Context#bindService bindService()}</code> に渡して、他のコンポーネントからのサービスにバインドできます。 詳細については、「<a href="{@docRoot}guide/components/services.html">サービス</a>」のガイドをご覧ください。</p></li> -<li><b>ブロードキャストを配信するには:</b> +<li><b>ブロードキャストを配信するには:</b> <p>ブロードキャストは、アプリが受け取ることのできるメッセージです。システムは、システムの起動や端末の充電開始など、さまざまなシステム イベントを配信します。他のアプリにブロードキャストを配信するには、{@link android.content.Intent} を {@link android.content.Context#sendBroadcast(Intent) sendBroadcast()}、{@link android.content.Context#sendOrderedBroadcast(Intent, String) sendOrderedBroadcast()}、{@link android.content.Context#sendStickyBroadcast sendStickyBroadcast()} のいずれかに渡します。 @@ -373,9 +373,7 @@ resolveActivity()} を呼び出します。 Intent sendIntent = new Intent(); sendIntent.setAction(Intent.ACTION_SEND); sendIntent.putExtra(Intent.EXTRA_TEXT, textMessage); -sendIntent.setType({@link - org.apache.http.protocol.HTTP#PLAIN_TEXT_TYPE - HTTP.PLAIN_TEXT_TYPE}); // "text/plain" MIME type +sendIntent.setType("text/plain"); // Verify that the intent will resolve to an activity if (sendIntent.resolveActivity(getPackageManager()) != null) { @@ -748,7 +746,7 @@ startActivity()} などの呼び出しを行いません。 <p class="note"><strong>注:</strong> Androidは自動的に、{@link android.content.Context#startActivity startActivity()} と {@link -android.app.Activity#startActivityForResult startActivityForResult()} に渡されるすべての暗黙的インテントに {@link android.content.Intent#CATEGORY_DEFAULT} カテゴリを自動的に適用します。そのため、アクティビティで暗黙的インテントを受け取りたい場合は、前出の {@code <intent-filter>} の例のように、アクティビティのインテント フィルタに {@code "android.intent.category.DEFAULT"} のカテゴリを含める必要があります。 +android.app.Activity#startActivityForResult startActivityForResult()} に渡されるすべての暗黙的インテントに {@link android.content.Intent#CATEGORY_DEFAULT} カテゴリを自動的に適用します。そのため、アクティビティで暗黙的インテントを受け取りたい場合は、前出の {@code <intent-filter>} の例のように、アクティビティのインテント フィルタに {@code "android.intent.category.DEFAULT"} のカテゴリを含める必要があります。 diff --git a/docs/html-intl/intl/ja/guide/topics/providers/contacts-provider.jd b/docs/html-intl/intl/ja/guide/topics/providers/contacts-provider.jd index 60154b25a390..e12b62f222c5 100644 --- a/docs/html-intl/intl/ja/guide/topics/providers/contacts-provider.jd +++ b/docs/html-intl/intl/ja/guide/topics/providers/contacts-provider.jd @@ -57,7 +57,7 @@ page.title=連絡先プロバイダ <li>{@link android.provider.ContactsContract.Contacts}</li> <li>{@link android.provider.ContactsContract.RawContacts}</li> <li>{@link android.provider.ContactsContract.Data}</li> - <li>{@link android.provider.ContactsContract.StreamItems}</li> + <li>{@code android.provider.ContactsContract.StreamItems}</li> </ol> <h2>関連サンプル</h2> <ol> @@ -168,7 +168,7 @@ page.title=連絡先プロバイダ <p> 未加工連絡先データの大半は、{@link android.provider.ContactsContract.RawContacts} テーブルには格納されません。 その代わり、{@link android.provider.ContactsContract.Data} テーブルの 1 つまたは複数の行に格納されています。 -各データ行には列 {@link android.provider.ContactsContract.DataColumns#RAW_CONTACT_ID Data.RAW_CONTACT_ID} があり、親 {@link android.provider.ContactsContract.RawContacts} 行の {@link android.provider.BaseColumns#_ID RawContacts._ID} 値が格納されています。 +各データ行には列 {@link android.provider.ContactsContract.DataColumns#RAW_CONTACT_ID Data.RAW_CONTACT_ID} があり、親 {@link android.provider.ContactsContract.RawContacts} 行の {@code android.provider.BaseColumns#_ID RawContacts._ID} 値が格納されています。 @@ -481,16 +481,16 @@ page.title=連絡先プロバイダ </p> <p> - {@link android.provider.ContactsContract.Contacts} テーブルには列 {@link android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} もあり、こちらは連絡先の行への「永久」リンクです。 + {@link android.provider.ContactsContract.Contacts} テーブルには列 {@code android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} もあり、こちらは連絡先の行への「永久」リンクです。 -連絡先プロバイダは連絡先を自動的に管理するため、集約や同期が行われると、それに応じて連絡先の行の {@link android.provider.BaseColumns#_ID} 値が変更される場合があります。 +連絡先プロバイダは連絡先を自動的に管理するため、集約や同期が行われると、それに応じて連絡先の行の {@code android.provider.BaseColumns#_ID} 値が変更される場合があります。 -この処理が行われても、コンテンツ URI {@link android.provider.ContactsContract.Contacts#CONTENT_LOOKUP_URI} と連絡先の {@link android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} の組み合わせは、引き続きその連絡先の行を指すため、{@link android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} を使用して「お気に入り」の連絡先へのリンクを管理するなどができます。 +この処理が行われても、コンテンツ URI {@link android.provider.ContactsContract.Contacts#CONTENT_LOOKUP_URI} と連絡先の {@code android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} の組み合わせは、引き続きその連絡先の行を指すため、{@code android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} を使用して「お気に入り」の連絡先へのリンクを管理するなどができます。 -この列には、{@link android.provider.BaseColumns#_ID} 列の形式と関係のない独自の形式があります。 +この列には、{@code android.provider.BaseColumns#_ID} 列の形式と関係のない独自の形式があります。 </p> <p> @@ -598,7 +598,7 @@ page.title=連絡先プロバイダ </p> <p> - ユーザー プロファイルにアクセスするには、特別なパーミッションが必要です。読み取りと書き込みに必要な {@link android.Manifest.permission#READ_CONTACTS} パーミッションと {@link android.Manifest.permission#WRITE_CONTACTS} パーミッションの他に、ユーザー プロファイルに対する読み取りと書き込みのために {@link android.Manifest.permission#READ_PROFILE} パーミッションと {@link android.Manifest.permission#WRITE_PROFILE} パーミッションがそれぞれ必要です。 + ユーザー プロファイルにアクセスするには、特別なパーミッションが必要です。読み取りと書き込みに必要な {@link android.Manifest.permission#READ_CONTACTS} パーミッションと {@link android.Manifest.permission#WRITE_CONTACTS} パーミッションの他に、ユーザー プロファイルに対する読み取りと書き込みのために {@code android.Manifest.permission#READ_PROFILE} パーミッションと {@code android.Manifest.permission#WRITE_PROFILE} パーミッションがそれぞれ必要です。 @@ -606,7 +606,7 @@ page.title=連絡先プロバイダ </p> <p> - ユーザーのプロファイルは秘密性の高い情報であることを再度ご確認ください。パーミッション {@link android.Manifest.permission#READ_PROFILE} を使用すると、端末ユーザーの個人識別データにアクセスできます。 + ユーザーのプロファイルは秘密性の高い情報であることを再度ご確認ください。パーミッション {@code android.Manifest.permission#READ_PROFILE} を使用すると、端末ユーザーの個人識別データにアクセスできます。 アプリケーションの説明には、ユーザー プロファイルへのアクセス パーミッションが必要な理由を必ず記載してください。 @@ -975,7 +975,7 @@ public Loader<Cursor> onCreateLoader(int id, Bundle args) { </p> <h4>変更の後方参照</h4> <p> - 新しい未加工連絡先の行とその関連データの行を 1 組の {@link android.content.ContentProviderOperation} オブジェクトとして挿入している場合は、データの行を未加工連絡先の行にリンクする必要があります。そのためには、未加工連絡先の {@link android.provider.BaseColumns#_ID} 値を {@link android.provider.ContactsContract.DataColumns#RAW_CONTACT_ID} 値として挿入します。 + 新しい未加工連絡先の行とその関連データの行を 1 組の {@link android.content.ContentProviderOperation} オブジェクトとして挿入している場合は、データの行を未加工連絡先の行にリンクする必要があります。そのためには、未加工連絡先の {@code android.provider.BaseColumns#_ID} 値を {@link android.provider.ContactsContract.DataColumns#RAW_CONTACT_ID} 値として挿入します。 @@ -1010,7 +1010,7 @@ public Loader<Cursor> onCreateLoader(int id, Bundle args) { <code>previousResult</code> 値はそうした結果の 1 つのインデックスで、<code>key</code> 値を使用して取得され、格納されます。 -これにより、新しい未加工連絡先レコードを挿入してその {@link android.provider.BaseColumns#_ID} 値に戻り、次に {@link android.provider.ContactsContract.Data} 行を追加するときにその値を「後方参照」できます。 +これにより、新しい未加工連絡先レコードを挿入してその {@code android.provider.BaseColumns#_ID} 値に戻り、次に {@link android.provider.ContactsContract.Data} 行を追加するときにその値を「後方参照」できます。 <p> @@ -1089,7 +1089,7 @@ protected void createContactEntry() { 操作の各ビルダー オブジェクトは、{@link android.content.ContentProviderOperation.Builder#withValueBackReference(String, int) withValueBackReference()} を使用して {@link android.provider.ContactsContract.DataColumns#RAW_CONTACT_ID} を取得します。 -この参照が最初の操作からの {@link android.content.ContentProviderResult} オブジェクトを後方参照しており、それが未加工連絡先の行を追加し、新しい {@link android.provider.BaseColumns#_ID} 値を返します。 +この参照が最初の操作からの {@link android.content.ContentProviderResult} オブジェクトを後方参照しており、それが未加工連絡先の行を追加し、新しい {@code android.provider.BaseColumns#_ID} 値を返します。 その結果、各データ行はその {@link android.provider.ContactsContract.DataColumns#RAW_CONTACT_ID} によって、属する新しい {@link android.provider.ContactsContract.RawContacts} 行に自動的にリンクされます。 @@ -1228,7 +1228,7 @@ protected void createContactEntry() { <li> 制約を強制するのに適した {@link android.content.ContentProviderOperation.Builder} オブジェクトを、メソッド {@link android.content.ContentProviderOperation#newAssertQuery(Uri)} を使用して作成します。 -コンテンツ URI に、未加工連絡先の {@link android.provider.BaseColumns#_ID} が末尾に追加された {@link android.provider.ContactsContract.RawContacts#CONTENT_URI RawContacts.CONTENT_URI} を使用します。 +コンテンツ URI に、未加工連絡先の {@code android.provider.BaseColumns#_ID} が末尾に追加された {@link android.provider.ContactsContract.RawContacts#CONTENT_URI RawContacts.CONTENT_URI} を使用します。 @@ -1821,7 +1821,7 @@ startActivity(insertIntent); </dl> <h2 id="SocialStream">ソーシャル ストリーム データ</h2> <p> - {@link android.provider.ContactsContract.StreamItems} テーブルと {@link android.provider.ContactsContract.StreamItemPhotos} テーブルは、ソーシャル ネットワークからの受信データを管理します。 + {@code android.provider.ContactsContract.StreamItems} テーブルと {@code android.provider.ContactsContract.StreamItemPhotos} テーブルは、ソーシャル ネットワークからの受信データを管理します。 独自ネットワークからのストリーム データをこれらのテーブルに追加する同期アダプタを作成したり、ストリーム データをこれらのテーブルから読み込んで独自アプリケーションに表示したり、この両方を行ったりできます。 @@ -1830,7 +1830,7 @@ startActivity(insertIntent); </p> <h3 id="StreamText">ソーシャル ストリーム テキスト</h3> <p> - ストリーム アイテムは、必ず未加工連絡先に関連付けられます。{@link android.provider.ContactsContract.StreamItemsColumns#RAW_CONTACT_ID} は、未加工連絡先の <code>_ID</code> 値にリンクされます。 + ストリーム アイテムは、必ず未加工連絡先に関連付けられます。{@code android.provider.ContactsContract.StreamItemsColumns#RAW_CONTACT_ID} は、未加工連絡先の <code>_ID</code> 値にリンクされます。 未加工連絡先のアカウント タイプとアカウント名は、ストリーム アイテム行にも格納されます。 @@ -1840,14 +1840,14 @@ startActivity(insertIntent); </p> <dl> <dt> - {@link android.provider.ContactsContract.StreamItemsColumns#ACCOUNT_TYPE} + {@code android.provider.ContactsContract.StreamItemsColumns#ACCOUNT_TYPE} </dt> <dd> <strong>必須</strong>。このストリーム アイテムに関連付けられている未加工連絡先の、ユーザーのアカウント タイプ。 ストリーム アイテムを挿入する際には、この値を忘れずに設定してください。 </dd> <dt> - {@link android.provider.ContactsContract.StreamItemsColumns#ACCOUNT_NAME} + {@code android.provider.ContactsContract.StreamItemsColumns#ACCOUNT_NAME} </dt> <dd> <strong>必須</strong>。このストリーム アイテムに関連付けられている未加工連絡先の、ユーザーのアカウント名。 @@ -1861,30 +1861,30 @@ startActivity(insertIntent); <ul> <li> - {@link android.provider.ContactsContract.StreamItemsColumns#CONTACT_ID}:このストリーム アイテムが関連付けられている連絡先の {@link android.provider.BaseColumns#_ID} 値。 + {@code android.provider.ContactsContract.StreamItemsColumns#CONTACT_ID}:このストリーム アイテムが関連付けられている連絡先の {@code android.provider.BaseColumns#_ID} 値。 </li> <li> - {@link android.provider.ContactsContract.StreamItemsColumns#CONTACT_LOOKUP_KEY}: このストリーム アイテムが関連付けられている連絡先の {@link android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} 値。 + {@code android.provider.ContactsContract.StreamItemsColumns#CONTACT_LOOKUP_KEY}: このストリーム アイテムが関連付けられている連絡先の {@code android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} 値。 </li> <li> - {@link android.provider.ContactsContract.StreamItemsColumns#RAW_CONTACT_ID}:このストリーム アイテムが関連付けられている未加工連絡先の {@link android.provider.BaseColumns#_ID} 値。 + {@code android.provider.ContactsContract.StreamItemsColumns#RAW_CONTACT_ID}:このストリーム アイテムが関連付けられている未加工連絡先の {@code android.provider.BaseColumns#_ID} 値。 </li> </ul> </dd> <dt> - {@link android.provider.ContactsContract.StreamItemsColumns#COMMENTS} + {@code android.provider.ContactsContract.StreamItemsColumns#COMMENTS} </dt> <dd> 省略可能。ストリーム アイテムの冒頭に表示できる概要情報を格納します。 </dd> <dt> - {@link android.provider.ContactsContract.StreamItemsColumns#TEXT} + {@code android.provider.ContactsContract.StreamItemsColumns#TEXT} </dt> <dd> ストリーム アイテムのテキスト。アイテムのソースによって投稿されたコンテンツか、そのストリーム アイテムを生成した何らかのアクションに関する説明です。 @@ -1894,7 +1894,7 @@ startActivity(insertIntent); </dd> <dt> - {@link android.provider.ContactsContract.StreamItemsColumns#TIMESTAMP} + {@code android.provider.ContactsContract.StreamItemsColumns#TIMESTAMP} </dt> <dd> ストリーム アイテムが挿入またはアップデートされた時刻を含むテキスト。エポックからのミリ秒<em></em>の形式です。 @@ -1904,22 +1904,22 @@ startActivity(insertIntent); </dd> </dl> <p> - ストリーム アイテムの識別情報を表示するには、{@link android.provider.ContactsContract.StreamItemsColumns#RES_ICON}、{@link android.provider.ContactsContract.StreamItemsColumns#RES_LABEL}、{@link android.provider.ContactsContract.StreamItemsColumns#RES_PACKAGE} を使用してアプリケーション内のリソースにリンクします。 + ストリーム アイテムの識別情報を表示するには、{@code android.provider.ContactsContract.StreamItemsColumns#RES_ICON}、{@code android.provider.ContactsContract.StreamItemsColumns#RES_LABEL}、{@code android.provider.ContactsContract.StreamItemsColumns#RES_PACKAGE} を使用してアプリケーション内のリソースにリンクします。 </p> <p> - {@link android.provider.ContactsContract.StreamItems} テーブルには、同期アダプタ専用に列 {@link android.provider.ContactsContract.StreamItemsColumns#SYNC1} ～ {@link android.provider.ContactsContract.StreamItemsColumns#SYNC4} も格納されます。 + {@code android.provider.ContactsContract.StreamItems} テーブルには、同期アダプタ専用に列 {@code android.provider.ContactsContract.StreamItemsColumns#SYNC1} ～ {@code android.provider.ContactsContract.StreamItemsColumns#SYNC4} も格納されます。 </p> <h3 id="StreamPhotos">ソーシャル ストリーム フォト</h3> <p> - {@link android.provider.ContactsContract.StreamItemPhotos} テーブルには、ストリーム アイテムに関連付けられた写真が格納されます。 -このテーブルの {@link android.provider.ContactsContract.StreamItemPhotosColumns#STREAM_ITEM_ID} 列は、{@link android.provider.ContactsContract.StreamItems} テーブルの {@link android.provider.BaseColumns#_ID} 列の値にリンクされます。 + {@code android.provider.ContactsContract.StreamItemPhotos} テーブルには、ストリーム アイテムに関連付けられた写真が格納されます。 +このテーブルの {@code android.provider.ContactsContract.StreamItemPhotosColumns#STREAM_ITEM_ID} 列は、{@code android.provider.ContactsContract.StreamItems} テーブルの {@code android.provider.BaseColumns#_ID} 列の値にリンクされます。 写真の参照は、テーブルの次の列に格納されます。 @@ -1927,20 +1927,20 @@ startActivity(insertIntent); </p> <dl> <dt> - {@link android.provider.ContactsContract.StreamItemPhotos#PHOTO} 列（BLOB）。 + {@code android.provider.ContactsContract.StreamItemPhotos#PHOTO} 列（BLOB）。 </dt> <dd> 写真のバイナリ表現。格納や表示のためにプロバイダによってサイズが変更されます。 この列は、写真を格納するために使用されていた連絡先プロバイダの従来のバージョンとの下方互換性のために用意されています。 ただし、現在のバージョンでは、写真の格納にこの列を使用しないでください。 -代わりに、{@link android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_FILE_ID} または {@link android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_URI}（どちらについても次の項目で説明します）を使用して、写真をファイルに保存します。 +代わりに、{@code android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_FILE_ID} または {@code android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_URI}（どちらについても次の項目で説明します）を使用して、写真をファイルに保存します。 現状では、この列には写真のサムネイルが格納されており、読み出し可能です。 </dd> <dt> - {@link android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_FILE_ID} + {@code android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_FILE_ID} </dt> <dd> 未加工連絡先の写真の数値 ID。この値を定数 {@link android.provider.ContactsContract.DisplayPhoto#CONTENT_URI DisplayPhoto.CONTENT_URI} の末尾に追加して、1 つの写真ファイルを指すコンテンツ URI を取得し、{@link android.content.ContentResolver#openAssetFileDescriptor(Uri, String) openAssetFileDescriptor()} を呼び出して、その写真ファイルのハンドルを取得します。 @@ -1950,7 +1950,7 @@ startActivity(insertIntent); </dd> <dt> - {@link android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_URI} + {@code android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_URI} </dt> <dd> この行によって表されている写真の写真ファイルを直接指すコンテンツ URI。 @@ -1964,27 +1964,27 @@ startActivity(insertIntent); </p> <ul> <li> - これらのテーブルには、追加のアクセス パーミッションが必要です。これらからの読み出しには、アプリケーションにパーミッション {@link android.Manifest.permission#READ_SOCIAL_STREAM} が必要です。 -これらの変更には、アプリケーションにパーミッション {@link android.Manifest.permission#WRITE_SOCIAL_STREAM} が必要です。 + これらのテーブルには、追加のアクセス パーミッションが必要です。これらからの読み出しには、アプリケーションにパーミッション {@code android.Manifest.permission#READ_SOCIAL_STREAM} が必要です。 +これらの変更には、アプリケーションにパーミッション {@code android.Manifest.permission#WRITE_SOCIAL_STREAM} が必要です。 </li> <li> - {@link android.provider.ContactsContract.StreamItems} テーブルについては、各未加工連絡先に格納できる行数に上限があります。 -上限に達すると、連絡先プロバイダは最も古い {@link android.provider.ContactsContract.StreamItemsColumns#TIMESTAMP} を持つ行を自動的に削除して、新しいストリーム アイテムのための領域を作ります。 + {@code android.provider.ContactsContract.StreamItems} テーブルについては、各未加工連絡先に格納できる行数に上限があります。 +上限に達すると、連絡先プロバイダは最も古い {@code android.provider.ContactsContract.StreamItemsColumns#TIMESTAMP} を持つ行を自動的に削除して、新しいストリーム アイテムのための領域を作ります。 -この上限を取得するには、コンテンツ URI {@link android.provider.ContactsContract.StreamItems#CONTENT_LIMIT_URI} にクエリを発行します。 +この上限を取得するには、コンテンツ URI {@code android.provider.ContactsContract.StreamItems#CONTENT_LIMIT_URI} にクエリを発行します。 コンテンツ URI を除くすべての引数は、<code>null</code> のままでかまいません。 -このクエリは、列 {@link android.provider.ContactsContract.StreamItems#MAX_ITEMS} だけの 1 行を含む Cursor を返します。 +このクエリは、列 {@code android.provider.ContactsContract.StreamItems#MAX_ITEMS} だけの 1 行を含む Cursor を返します。 </li> </ul> <p> - クラス {@link android.provider.ContactsContract.StreamItems.StreamItemPhotos} は、1 つのストリーム アイテムの写真行を含む {@link android.provider.ContactsContract.StreamItemPhotos} のサブテーブルを定義します。 + クラス {@code android.provider.ContactsContract.StreamItems.StreamItemPhotos} は、1 つのストリーム アイテムの写真行を含む {@code android.provider.ContactsContract.StreamItemPhotos} のサブテーブルを定義します。 </p> @@ -1996,7 +1996,7 @@ startActivity(insertIntent); </p> <ul> <li> - ソーシャル ネットワーキング サービスを連絡先プロバイダに同期アダプタを使用して同期することで、ユーザーの連絡先による最近のアクティビティを取得し、それを {@link android.provider.ContactsContract.StreamItems} テーブルや {@link android.provider.ContactsContract.StreamItemPhotos} テーブルに格納して後で使えるようにできます。 + ソーシャル ネットワーキング サービスを連絡先プロバイダに同期アダプタを使用して同期することで、ユーザーの連絡先による最近のアクティビティを取得し、それを {@code android.provider.ContactsContract.StreamItems} テーブルや {@code android.provider.ContactsContract.StreamItemPhotos} テーブルに格納して後で使えるようにできます。 @@ -2328,7 +2328,7 @@ Google+ サークルのどれかをクリックすると、そのサークルに <p> {@link android.provider.ContactsContract.Data} テーブルは、写真を MIME タイプ {@link android.provider.ContactsContract.CommonDataKinds.Photo#CONTENT_ITEM_TYPE Photo.CONTENT_ITEM_TYPE} の行として格納します。 -この行の {@link android.provider.ContactsContract.RawContactsColumns#CONTACT_ID} 列は、それが属する未加工連絡先の {@link android.provider.BaseColumns#_ID} 列にリンクされます。 +この行の {@link android.provider.ContactsContract.RawContactsColumns#CONTACT_ID} 列は、それが属する未加工連絡先の {@code android.provider.BaseColumns#_ID} 列にリンクされます。 クラス {@link android.provider.ContactsContract.Contacts.Photo} は、連絡先のプライマリ フォトの写真情報を格納する {@link android.provider.ContactsContract.Contacts} のサブテーブルを定義します。ここでプライマリ フォトとは、連絡先のプライマリ未加工連絡先のプライマリ フォトのことを示します。 @@ -2341,7 +2341,7 @@ Google+ サークルのどれかをクリックすると、そのサークルに <p> {@link android.provider.ContactsContract.Contacts.Photo} と {@link android.provider.ContactsContract.RawContacts.DisplayPhoto} の参照ドキュメントには、写真情報の取得例が含まれています。 -未加工連絡先のプライマリ サムネイルを取得するための便利なクラスはありませんが、{@link android.provider.ContactsContract.Data} テーブルにクエリを送信して、未加工連絡先の {@link android.provider.BaseColumns#_ID}、{@link android.provider.ContactsContract.CommonDataKinds.Photo#CONTENT_ITEM_TYPE Photo.CONTENT_ITEM_TYPE}、{@link android.provider.ContactsContract.Data#IS_PRIMARY} 列を選んでその未加工連絡先のプライマリ フォト行を探すことができます。 +未加工連絡先のプライマリ サムネイルを取得するための便利なクラスはありませんが、{@link android.provider.ContactsContract.Data} テーブルにクエリを送信して、未加工連絡先の {@code android.provider.BaseColumns#_ID}、{@link android.provider.ContactsContract.CommonDataKinds.Photo#CONTENT_ITEM_TYPE Photo.CONTENT_ITEM_TYPE}、{@link android.provider.ContactsContract.Data#IS_PRIMARY} 列を選んでその未加工連絡先のプライマリ フォト行を探すことができます。 @@ -2350,7 +2350,7 @@ Google+ サークルのどれかをクリックすると、そのサークルに </p> <p> - 人のソーシャル ストリーム データにも写真が含まれていることがあります。その場合は {@link android.provider.ContactsContract.StreamItemPhotos} テーブルに格納されています。このテーブルについては、<a href="#StreamPhotos">ソーシャル ストリーム フォト</a>で詳しく説明しています + 人のソーシャル ストリーム データにも写真が含まれていることがあります。その場合は {@code android.provider.ContactsContract.StreamItemPhotos} テーブルに格納されています。このテーブルについては、<a href="#StreamPhotos">ソーシャル ストリーム フォト</a>で詳しく説明しています </p> diff --git a/docs/html-intl/intl/ko/guide/components/intents-filters.jd b/docs/html-intl/intl/ko/guide/components/intents-filters.jd index 2586200bcc2f..1488a1dd6472 100644 --- a/docs/html-intl/intl/ko/guide/components/intents-filters.jd +++ b/docs/html-intl/intl/ko/guide/components/intents-filters.jd @@ -43,41 +43,41 @@ page.tags="IntentFilter" -<p>{@link android.content.Intent}는 일종의 메시지 객체입니다. 이것을 사용해 다른 -<a href="{@docRoot}guide/components/fundamentals.html#Components">앱 구성 요소</a>로부터 작업을 요청할 수 있습니다. -인텐트가 여러 구성 요소 사이의 통신을 용이하게 하는 데에는 몇 가지 방법이 있지만, +<p>{@link android.content.Intent}는 일종의 메시지 객체입니다. 이것을 사용해 다른 +<a href="{@docRoot}guide/components/fundamentals.html#Components">앱 구성 요소</a>로부터 작업을 요청할 수 있습니다. +인텐트가 여러 구성 요소 사이의 통신을 용이하게 하는 데에는 몇 가지 방법이 있지만, 기본적인 사용 사례는 다음과 같은 세 가지입니다.</p> <ul> <li><b>액티비티 시작하기:</b> -<p>{@link android.app.Activity}는 앱 안의 화면 하나를 나타냅니다. -{@link android.app.Activity}의 새 인스턴스를 시작하려면 {@link android.content.Intent}를 -{@link android.content.Context#startActivity startActivity()}로 전달하면 됩니다. {@link android.content.Intent}는 +<p>{@link android.app.Activity}는 앱 안의 화면 하나를 나타냅니다. +{@link android.app.Activity}의 새 인스턴스를 시작하려면 {@link android.content.Intent}를 +{@link android.content.Context#startActivity startActivity()}로 전달하면 됩니다. {@link android.content.Intent}는 시작할 액티비티를 설명하고 모든 필수 데이터를 담고 있습니다.</p> -<p>액티비티가 완료되었을 때 결과를 수신하려면, +<p>액티비티가 완료되었을 때 결과를 수신하려면, {@link android.app.Activity#startActivityForResult startActivityForResult()}를 호출합니다. 액티비티는 해당 결과를 액티비티의 {@link -android.app.Activity#onActivityResult onActivityResult()} 콜백에서 별도의 -{@link android.content.Intent} 객체로 수신합니다. +android.app.Activity#onActivityResult onActivityResult()} 콜백에서 별도의 +{@link android.content.Intent} 객체로 수신합니다. 자세한 정보는 <a href="{@docRoot}guide/components/activities.html">액티비티</a> 가이드를 참조하십시오.</p></li> <li><b>서비스 시작하기:</b> -<p>{@link android.app.Service}는 사용자 인터페이스 없이 +<p>{@link android.app.Service}는 사용자 인터페이스 없이 배경에서 작업을 수행하는 구성 요소입니다. 서비스를 시작하여 일회성 작업을 수행하도록 하려면(예: 파일 다운로드) -{@link android.content.Intent}를 +{@link android.content.Intent}를 {@link android.content.Context#startService startService()}에 전달하면 됩니다. {@link android.content.Intent}는 시작할 서비스를 설명하고 모든 필수 데이터를 담고 있습니다.</p> -<p>서비스가 클라이언트-서버 인터페이스로 설계된 경우, 다른 구성 요소로부터 +<p>서비스가 클라이언트-서버 인터페이스로 설계된 경우, 다른 구성 요소로부터 서비스에 바인딩하려면 {@link android.content.Intent}를 {@link android.content.Context#bindService bindService()}에 전달하면 됩니다.</code> 자세한 정보는 <a href="{@docRoot}guide/components/services.html">서비스</a> 가이드를 참조하십시오.</p></li> <li><b>브로드캐스트 전달하기:</b> -<p>브로드캐스트는 모든 앱이 수신할 수 있는 메시지입니다. 시스템은 여러 시스템 이벤트에 대해 다양한 -브로드캐스트를 전달합니다. 예를 들어 시스템이 부팅될 때 또는 기기가 변경되기 시작할 때 등이 해당됩니다. -다른 여러 앱에 브로드캐스트를 전달하려면 {@link android.content.Intent}를 -{@link android.content.Context#sendBroadcast(Intent) sendBroadcast()}, +<p>브로드캐스트는 모든 앱이 수신할 수 있는 메시지입니다. 시스템은 여러 시스템 이벤트에 대해 다양한 +브로드캐스트를 전달합니다. 예를 들어 시스템이 부팅될 때 또는 기기가 변경되기 시작할 때 등이 해당됩니다. +다른 여러 앱에 브로드캐스트를 전달하려면 {@link android.content.Intent}를 +{@link android.content.Context#sendBroadcast(Intent) sendBroadcast()}, {@link android.content.Context#sendOrderedBroadcast(Intent, String) sendOrderedBroadcast()} 또는 {@link android.content.Context#sendStickyBroadcast sendStickyBroadcast()}에 전달하면 됩니다.</p> @@ -94,50 +94,50 @@ android.content.Context#sendStickyBroadcast sendStickyBroadcast()}에 전달하 <ul> <li><b>명시적 인텐트</b>는 시작할 구성 요소를 이름으로 지정합니다(완전히 정규화된 클래스 이름). 명시적 인텐트는 일반적으로 본인의 앱 안에서 구성 요소를 시작할 때 씁니다. -시작하고자 하는 액티비티 또는 서비스의 클래스 이름을 알고 있기 때문입니다. 예를 들어, -사용자 작업에 응답하여 새 액티비티를 시작하거나 배경에서 파일을 다운로드하기 위해 +시작하고자 하는 액티비티 또는 서비스의 클래스 이름을 알고 있기 때문입니다. 예를 들어, +사용자 작업에 응답하여 새 액티비티를 시작하거나 배경에서 파일을 다운로드하기 위해 서비스를 시작하는 것 등이 여기에 해당됩니다.</li> -<li><b>암시적 인텐트</b>는 특정 구성 요소의 이름을 대지 않지만, 그 대신 수행할 일반적일 작업을 -선언하여 또 다른 앱의 구성 요소가 이를 처리할 수 있도록 해줍니다. 예를 들어, 사용자에게 지도에 있는 한 위치를 -표시해주고자 하는 경우, 암시적 인텐트를 사용하여 다른, 해당 기능을 갖춘 앱이 +<li><b>암시적 인텐트</b>는 특정 구성 요소의 이름을 대지 않지만, 그 대신 수행할 일반적일 작업을 +선언하여 또 다른 앱의 구성 요소가 이를 처리할 수 있도록 해줍니다. 예를 들어, 사용자에게 지도에 있는 한 위치를 +표시해주고자 하는 경우, 암시적 인텐트를 사용하여 다른, 해당 기능을 갖춘 앱이 지정된 위치를 지도에 표시하도록 요청할 수 있습니다.</li> </ul> -<p>명시적 인텐트를 생성하여 액티비티나 서비스를 시작하도록 하면, 시스템이 즉시 +<p>명시적 인텐트를 생성하여 액티비티나 서비스를 시작하도록 하면, 시스템이 즉시 {@link android.content.Intent} 객체에서 지정된 앱 구성 요소를 시작합니다.</p> <div class="figure" style="width:446px"> <img src="{@docRoot}images/components/intent-filters@2x.png" width="446" alt="" /> -<p class="img-caption"><strong>그림 1.</strong> 암시적 인텐트가 시스템을 통해 전달되어 -다른 액티비티를 시작하게 하는 방법을 그림으로 나타낸 것입니다. <b>[1]</b> <em>액티비티 A</em>가 작업 설명이 들어 있는 +<p class="img-caption"><strong>그림 1.</strong> 암시적 인텐트가 시스템을 통해 전달되어 +다른 액티비티를 시작하게 하는 방법을 그림으로 나타낸 것입니다. <b>[1]</b> <em>액티비티 A</em>가 작업 설명이 들어 있는 {@link android.content.Intent}를 생성하여 이를 {@link -android.content.Context#startActivity startActivity()}에 전달합니다. <b>[2]</b> Android 시스템이 -해당 인텐트와 일치하는 인텐트 필터를 찾아 모든 앱을 검색합니다. 일치하는 것을 찾으면, <b>[3]</b> 시스템이 +android.content.Context#startActivity startActivity()}에 전달합니다. <b>[2]</b> Android 시스템이 +해당 인텐트와 일치하는 인텐트 필터를 찾아 모든 앱을 검색합니다. 일치하는 것을 찾으면, <b>[3]</b> 시스템이 일치하는 액티비티(<em>액티비티 B</em>)를 시작하기 위해 그 액티비티의 {@link android.app.Activity#onCreate onCreate()} 메서드를 호출하여 이를 {@link android.content.Intent}에 전달합니다. </p> </div> -<p>암시적 인텐트를 생성하면 Android 시스템이 시작시킬 적절한 구성 요소를 찾습니다. -이때 인텐트의 내용을 기기에 있는 다른 여러 앱의 <a href="{@docRoot}guide/topics/manifest/manifest-intro.html">매니페스트 파일</a>에서 선언된 <em>인텐트 필터</em>와 비교하는 방법을 -씁니다. 해당 인텐트와 일치하는 인텐트 필터가 있으면 시스템이 해당 구성 요소를 시작하고 이에 -{@link android.content.Intent} 객체를 전달합니다. 호환되는 인텐트 필터가 여러 개인 경우, 시스템은 +<p>암시적 인텐트를 생성하면 Android 시스템이 시작시킬 적절한 구성 요소를 찾습니다. +이때 인텐트의 내용을 기기에 있는 다른 여러 앱의 <a href="{@docRoot}guide/topics/manifest/manifest-intro.html">매니페스트 파일</a>에서 선언된 <em>인텐트 필터</em>와 비교하는 방법을 +씁니다. 해당 인텐트와 일치하는 인텐트 필터가 있으면 시스템이 해당 구성 요소를 시작하고 이에 +{@link android.content.Intent} 객체를 전달합니다. 호환되는 인텐트 필터가 여러 개인 경우, 시스템은 대화를 표시하여 사용자가 어느 앱을 사용할지 직접 선택할 수 있게 합니다.</p> -<p>인텐트 필터란 앱의 매니페스트 파일에 들어 있는 표현으로, -해당 구성 요소가 수신하고자 하는 인텐트의 유형을 -나타낸 것입니다. 예를 들어 액티비티에 대한 인텐트 필터를 선언하면 -다른 여러 앱이 특정한 종류의 인텐트를 가지고 여러분의 액티비티를 직접 시작할 수 있습니다. -이와 마찬가지로, 액티비티에 대한 인텐트 필터를 전혀 선언하지 <em>않으면</em> 명시적 인텐트로만 +<p>인텐트 필터란 앱의 매니페스트 파일에 들어 있는 표현으로, +해당 구성 요소가 수신하고자 하는 인텐트의 유형을 +나타낸 것입니다. 예를 들어 액티비티에 대한 인텐트 필터를 선언하면 +다른 여러 앱이 특정한 종류의 인텐트를 가지고 여러분의 액티비티를 직접 시작할 수 있습니다. +이와 마찬가지로, 액티비티에 대한 인텐트 필터를 전혀 선언하지 <em>않으면</em> 명시적 인텐트로만 시작할 수 있습니다.</p> -<p class="caution"><strong>주의:</strong> 앱의 보안을 보장하려면 -{@link android.app.Service}를 시작할 때에는 항상 명시적 인텐트만 사용하고 서비스에 대한 인텐트 필터는 -선언하지 마십시오. 암시적 인텐트를 사용하여 서비스를 시작하면 -보안 위험을 초래합니다. 인텐트에 어느 서비스가 응답할 것인지 확신할 수 없고, 사용자가 -어느 서비스가 시작되는지 볼 수 없기 때문입니다. Android 5.0(API 레벨 21)부터 시스템은 개발자가 암시적 인텐트로 -{@link android.content.Context#bindService bindService()}를 +<p class="caution"><strong>주의:</strong> 앱의 보안을 보장하려면 +{@link android.app.Service}를 시작할 때에는 항상 명시적 인텐트만 사용하고 서비스에 대한 인텐트 필터는 +선언하지 마십시오. 암시적 인텐트를 사용하여 서비스를 시작하면 +보안 위험을 초래합니다. 인텐트에 어느 서비스가 응답할 것인지 확신할 수 없고, 사용자가 +어느 서비스가 시작되는지 볼 수 없기 때문입니다. Android 5.0(API 레벨 21)부터 시스템은 개발자가 암시적 인텐트로 +{@link android.content.Context#bindService bindService()}를 호출하면 예외를 발생시킵니다.</p> @@ -146,9 +146,9 @@ android.app.Activity#onCreate onCreate()} 메서드를 호출하여 이를 {@lin <h2 id="Building">인텐트 구축</h2> -<p>{@link android.content.Intent} 객체에는 Android 시스템이 -어느 구성 요소를 시작할지 판별하는 데 사용하는 정보가 담겨 있습니다(예를 들어 정확한 구성 요소 이름 또는 인텐트를 -수신해야 하는 구성 요소 카테고리 등). 또한 수신자 구성 요소가 작업을 적절히 수행하기 위해 +<p>{@link android.content.Intent} 객체에는 Android 시스템이 +어느 구성 요소를 시작할지 판별하는 데 사용하는 정보가 담겨 있습니다(예를 들어 정확한 구성 요소 이름 또는 인텐트를 +수신해야 하는 구성 요소 카테고리 등). 또한 수신자 구성 요소가 작업을 적절히 수행하기 위해 사용할 정보(예: 수행할 작업 및 조치를 취할 데이터 위치 등)도 이 안에 담겨 있습니다.</p> @@ -159,23 +159,23 @@ android.app.Activity#onCreate onCreate()} 메서드를 호출하여 이를 {@lin <dt><b>구성 요소 이름</b></dt> <dd>시작할 구성 요소의 이름입니다. -<p>이것은 선택 항목이지만, 이것이 바로 인텐트를 -<b>명시적</b>인 것으로 만들어주는 중요한 정보입니다. 다시 말해 이 인텐트는 구성 요소 이름이 정의한 앱 구성 요소에만 -전달되어야 한다는 뜻입니다. 구성 요소 이름이 없으면 해당 인텐트는 <b>암시적</b>이며, -인텐트를 수신해야 하는 구성 요소는 다른 인텐트 정보를 기반으로 시스템이 -결정합니다(예를 들어 작업, 데이터 및 카테고리 — 아래 설명 참조). 따라서 앱에서 특정한 구성 요소를 +<p>이것은 선택 항목이지만, 이것이 바로 인텐트를 +<b>명시적</b>인 것으로 만들어주는 중요한 정보입니다. 다시 말해 이 인텐트는 구성 요소 이름이 정의한 앱 구성 요소에만 +전달되어야 한다는 뜻입니다. 구성 요소 이름이 없으면 해당 인텐트는 <b>암시적</b>이며, +인텐트를 수신해야 하는 구성 요소는 다른 인텐트 정보를 기반으로 시스템이 +결정합니다(예를 들어 작업, 데이터 및 카테고리 — 아래 설명 참조). 따라서 앱에서 특정한 구성 요소를 시작해야 하는 경우에는, 구성 요소 이름을 지정해야 합니다.</p> -<p class="note"><strong>참고:</strong> {@link android.app.Service}를 시작하는 경우, -<strong>항상 구성 요소 이름을 지정</strong>해야 합니다. 그렇지 않으면 인텐트에 어느 서비스가 응답할지 확신할 수 없고, +<p class="note"><strong>참고:</strong> {@link android.app.Service}를 시작하는 경우, +<strong>항상 구성 요소 이름을 지정</strong>해야 합니다. 그렇지 않으면 인텐트에 어느 서비스가 응답할지 확신할 수 없고, 사용자도 어느 서비스가 시작되는지 볼 수 없게 됩니다.</p> -<p>{@link android.content.Intent}의 필드는 -{@link android.content.ComponentName} 객체로, 이것을 지정하려면 대상 구성 요소의 완전히 -정규화된 클래스 이름(앱의 패키지 이름 포함)을 사용해야 합니다. 예를 들면 +<p>{@link android.content.Intent}의 필드는 +{@link android.content.ComponentName} 객체로, 이것을 지정하려면 대상 구성 요소의 완전히 +정규화된 클래스 이름(앱의 패키지 이름 포함)을 사용해야 합니다. 예를 들면 {@code com.example.ExampleActivity}를 쓰십시오. 구성 요소 이름을 설정하려면 {@link android.content.Intent#setComponent setComponent()}, {@link android.content.Intent#setClass -setClass()}, {@link android.content.Intent#setClassName(String, String) setClassName()}을 사용하거나, 아니면 +setClass()}, {@link android.content.Intent#setClassName(String, String) setClassName()}을 사용하거나, 아니면 {@link android.content.Intent} 생성자를 사용하면 됩니다.</p> </dd> @@ -184,86 +184,86 @@ setClass()}, {@link android.content.Intent#setClassName(String, String) setClass <dd>수행할 일반적인 작업을 나타내는 문자열입니다(예: <em>보기</em> 또는 <em>선택</em>). <p>브로드캐스트 인텐트의 경우, 이것이 발생한 작업이자 보고되는 것이기도 합니다. -인텐트의 나머지 부분이 어떻게 구조화될지는 대부분 작업이 결정합니다. 특히, +인텐트의 나머지 부분이 어떻게 구조화될지는 대부분 작업이 결정합니다. 특히, 데이터 안에 들어 있는 것과 추가 항목 등이 해당됩니다. -<p>본인의 앱 내에 있는 인텐트가 사용할 작업(또는 다른 앱이 사용하여 -본인의 앱 안의 구성 요소를 호출하도록 함)을 직접 지정할 수도 있지만, 보통은 -{@link android.content.Intent} 클래스나 다른 프레임워크 클래스가 정의한 작업 상수를 써야 합니다. 다음은 +<p>본인의 앱 내에 있는 인텐트가 사용할 작업(또는 다른 앱이 사용하여 +본인의 앱 안의 구성 요소를 호출하도록 함)을 직접 지정할 수도 있지만, 보통은 +{@link android.content.Intent} 클래스나 다른 프레임워크 클래스가 정의한 작업 상수를 써야 합니다. 다음은 액티비티를 시작하는 데 쓰이는 보편적인 작업입니다.</p> <dl> <dt>{@link android.content.Intent#ACTION_VIEW}</dt> <dd>이 작업은 액티비티가 사용자에게 표시할 수 있는 어떤 정보를 가지고 있을 때 {@link - android.content.Context#startActivity startActivity()}가 있는 인텐트에서 -사용합니다. 예를 들어 갤러리 앱에서 볼 사진이나 지도 앱에서 볼 주소 등이 + android.content.Context#startActivity startActivity()}가 있는 인텐트에서 +사용합니다. 예를 들어 갤러리 앱에서 볼 사진이나 지도 앱에서 볼 주소 등이 이에 해당됩니다.</dd> <dt>{@link android.content.Intent#ACTION_SEND}</dt> <dd>이것은 다른 이름으로 "공유" 인텐트라고도 합니다. 이것은 사용자가 다른 앱을 통해 공유할 수 있는 데이터를 가지고 있을 때 {@link - android.content.Context#startActivity startActivity()}가 있는 인텐트에서 사용합니다. 예를 들어 + android.content.Context#startActivity startActivity()}가 있는 인텐트에서 사용합니다. 예를 들어 이메일 앱 또는 소셜 공유 앱 등이 이에 해당됩니다.</dd> </dl> -<p>일반적인 작업을 정의하는 상수에 대한 자세한 내용은 {@link android.content.Intent} 클래스 -참조를 확인하십시오. 다른 작업은 Android 프레임워크의 다른 곳에서 정의됩니다. 예를 들어 -시스템의 설정 앱에서 특정 화면을 여는 작업의 경우 {@link android.provider.Settings}에서 +<p>일반적인 작업을 정의하는 상수에 대한 자세한 내용은 {@link android.content.Intent} 클래스 +참조를 확인하십시오. 다른 작업은 Android 프레임워크의 다른 곳에서 정의됩니다. 예를 들어 +시스템의 설정 앱에서 특정 화면을 여는 작업의 경우 {@link android.provider.Settings}에서 정의됩니다.</p> <p>인텐트에 대한 작업을 지정하려면 {@link android.content.Intent#setAction setAction()} 또는 {@link android.content.Intent} 생성자를 사용하면 됩니다.</p> -<p>나름의 작업을 직접 정의하는 경우, 앱의 패키지 이름을 접두사로 포함시켜야 +<p>나름의 작업을 직접 정의하는 경우, 앱의 패키지 이름을 접두사로 포함시켜야 합니다. 예:</p> <pre>static final String ACTION_TIMETRAVEL = "com.example.action.TIMETRAVEL";</pre> </dd> <dt><b>데이터</b></dt> -<dd>작업을 수행할 데이터 및/또는 해당 데이터의 MIME 유형을 참조하는 URI({@link android.net.Uri} -객체)입니다. 제공된 데이터의 유형을 나타내는 것은 일반적으로 인텐트의 작업입니다. 예를 들어 -인텐트가 {@link android.content.Intent#ACTION_EDIT}인 경우, 데이터에 +<dd>작업을 수행할 데이터 및/또는 해당 데이터의 MIME 유형을 참조하는 URI({@link android.net.Uri} +객체)입니다. 제공된 데이터의 유형을 나타내는 것은 일반적으로 인텐트의 작업입니다. 예를 들어 +인텐트가 {@link android.content.Intent#ACTION_EDIT}인 경우, 데이터에 편집할 문서의 URI가 들어있어야 합니다. -<p>인텐트를 생성할 때에는 -URI외에도 데이터의 유형(MIME 유형)을 지정하는 것이 중요한 경우가 많습니다. -예를 들어, 이미지를 표시할 수 있는 액티비티는 아마도 오디오 파일을 재생할 수 없을 가능성이 -큽니다. 두 가지 기능의 URI 형식은 비슷할지라도 말입니다. -그러므로 데이터의 MIME 유형을 지정해두면 Android 시스템이 +<p>인텐트를 생성할 때에는 +URI외에도 데이터의 유형(MIME 유형)을 지정하는 것이 중요한 경우가 많습니다. +예를 들어, 이미지를 표시할 수 있는 액티비티는 아마도 오디오 파일을 재생할 수 없을 가능성이 +큽니다. 두 가지 기능의 URI 형식은 비슷할지라도 말입니다. +그러므로 데이터의 MIME 유형을 지정해두면 Android 시스템이 인텐트를 수신할 최상의 구성 요소를 찾는 데 도움이 됩니다. -하지만, MIME 유형은 URI에서 추론되는 경우도 종종 있습니다. 특히 데이터가 -{@code content:} URI인 경우 더욱 그러한데, 이는 데이터가 기기에 위치하고 있으며 +하지만, MIME 유형은 URI에서 추론되는 경우도 종종 있습니다. 특히 데이터가 +{@code content:} URI인 경우 더욱 그러한데, 이는 데이터가 기기에 위치하고 있으며 {@link android.content.ContentProvider}가 제어한다는 것을 나타내어 해당 데이터 MIME 유형이 시스템에 표시되도록 합니다.</p> -<p>데이터 URI만 설정하려면 {@link android.content.Intent#setData setData()}를 호출하십시오. -MIME 유형만 설정하려면, {@link android.content.Intent#setType setType()}을 호출합니다. 필요한 경우, +<p>데이터 URI만 설정하려면 {@link android.content.Intent#setData setData()}를 호출하십시오. +MIME 유형만 설정하려면, {@link android.content.Intent#setType setType()}을 호출합니다. 필요한 경우, 두 가지를 모두 명시적으로 설정해도 됩니다. 이때는 {@link android.content.Intent#setDataAndType setDataAndType()}을 사용하십시오.</p> -<p class="caution"><strong>주의:</strong> URI와 MIME 유형을 둘 다 설정하고자 하는 경우, {@link android.content.Intent#setData setData()} 및 -{@link android.content.Intent#setType setType()}을 호출하면 -<strong>안 됩니다</strong>. 이 둘은 서로의 값을 무효화하기 때문입니다. URI와 MIME 유형을 둘 모두 설정하려면 -항상 {@link android.content.Intent#setDataAndType setDataAndType()}을 +<p class="caution"><strong>주의:</strong> URI와 MIME 유형을 둘 다 설정하고자 하는 경우, {@link android.content.Intent#setData setData()} 및 +{@link android.content.Intent#setType setType()}을 호출하면 +<strong>안 됩니다</strong>. 이 둘은 서로의 값을 무효화하기 때문입니다. URI와 MIME 유형을 둘 모두 설정하려면 +항상 {@link android.content.Intent#setDataAndType setDataAndType()}을 사용하십시오.</p> </dd> <p><dt><b>카테고리</b></dt> -<dd>인텐트를 처리해야 하는 구성 요소의 종류에 관한 추가 정보를 담은 -문자열입니다. 인텐트 안에는 카테고리 설명이 -얼마든지 들어있을 수 있지만, 대부분의 인텐트에는 카테고리가 없어도 됩니다. +<dd>인텐트를 처리해야 하는 구성 요소의 종류에 관한 추가 정보를 담은 +문자열입니다. 인텐트 안에는 카테고리 설명이 +얼마든지 들어있을 수 있지만, 대부분의 인텐트에는 카테고리가 없어도 됩니다. 다음은 몇 가지 보편적인 카테고리입니다. <dl> <dt>{@link android.content.Intent#CATEGORY_BROWSABLE}</dt> - <dd>대상 액티비티가 스스로 웹 브라우저가 자신을 시작해도 되도록 허용하여 + <dd>대상 액티비티가 스스로 웹 브라우저가 자신을 시작해도 되도록 허용하여 링크로 참조된 데이터를 표시하게 합니다. 예컨대 이미지나 이메일 메시지 등이 이에 해당합니다. </dd> <dt>{@link android.content.Intent#CATEGORY_LAUNCHER}</dt> - <dd>이 액티비티가 작업의 최초 액티비티이며, 이것이 시스템의 애플리케이션 시작 관리자에 + <dd>이 액티비티가 작업의 최초 액티비티이며, 이것이 시스템의 애플리케이션 시작 관리자에 목록으로 게재되어 있습니다. </dd> </dl> -<p>카테고리의 전체 목록을 보려면 {@link android.content.Intent} +<p>카테고리의 전체 목록을 보려면 {@link android.content.Intent} 클래스 설명을 참조하십시오.</p> <p>카테고리를 지정하려면 {@link android.content.Intent#addCategory addCategory()}를 사용하면 됩니다.</p> @@ -271,41 +271,41 @@ android.content.Intent#setDataAndType setDataAndType()}을 사용하십시오.</ </dl> -<p>위에 목록으로 나열된 이러한 특성(구성 요소 이름, 작업, 데이터 및 카테고리)은 인텐트를 정의하는 특성을 -나타냅니다. Android 시스템은 이와 같은 속성을 읽어 +<p>위에 목록으로 나열된 이러한 특성(구성 요소 이름, 작업, 데이터 및 카테고리)은 인텐트를 정의하는 특성을 +나타냅니다. Android 시스템은 이와 같은 속성을 읽어 어느 앱 구성 요소를 시작해야 할지 확인할 수 있습니다.</p> -<p>그러나 인텐트는 앱 구성 요소로 확인되는 방법에 영향을 미치지 않는 +<p>그러나 인텐트는 앱 구성 요소로 확인되는 방법에 영향을 미치지 않는 추가 정보도 담고 있을 수 있습니다. 인텐트가 제공할 수 있는 기타 정보는 다음과 같습니다.</p> <dl> <dt><b>추가 사항</b></dt> -<dd>요청한 작업을 수행하기 위해 필요한 추가 정보를 담고 있는 키-값 쌍입니다. +<dd>요청한 작업을 수행하기 위해 필요한 추가 정보를 담고 있는 키-값 쌍입니다. 몇몇 작업이 특정한 종류의 데이터 URI를 사용하는 것과 마찬가지로, 몇몇 작업은 특정한 추가 사항도 사용합니다. -<p>추가 데이터를 추가하려면 여러 가지 {@link android.content.Intent#putExtra putExtra()} 메서드를 -사용할 수 있습니다. 이들은 각기 두 개의 매개변수를 허용합니다. 즉 키 이름과 값입니다. -모든 추가 데이터를 가진 {@link android.os.Bundle} 객체를 생성할 수도 있고, 그런 다음 +<p>추가 데이터를 추가하려면 여러 가지 {@link android.content.Intent#putExtra putExtra()} 메서드를 +사용할 수 있습니다. 이들은 각기 두 개의 매개변수를 허용합니다. 즉 키 이름과 값입니다. +모든 추가 데이터를 가진 {@link android.os.Bundle} 객체를 생성할 수도 있고, 그런 다음 {@link android.os.Bundle}을 {@link android.content.Intent}에 {@link android.content.Intent#putExtras putExtras()}로 삽입해도 됩니다.</p> -<p>예를 들어 -{@link android.content.Intent#ACTION_SEND}로 이메일을 전송할 인텐트를 생성하는 경우 "받는 사람" 수신자를 지정할 때 -{@link android.content.Intent#EXTRA_EMAIL} 키를 사용한 다음 "제목"은 +<p>예를 들어 +{@link android.content.Intent#ACTION_SEND}로 이메일을 전송할 인텐트를 생성하는 경우 "받는 사람" 수신자를 지정할 때 +{@link android.content.Intent#EXTRA_EMAIL} 키를 사용한 다음 "제목"은 {@link android.content.Intent#EXTRA_SUBJECT} 키로 지정하면 됩니다.</p> -<p>{@link android.content.Intent} 클래스는 표준화된 데이터 유형에 대해 수많은 {@code EXTRA_*} 상수를 -지정합니다. 나름의 추가 키를 선언해야 하는 경우(본인의 앱이 수신할 -인텐트에 대하여), 앱의 패키지 이름을 접두사로 포함시커야 +<p>{@link android.content.Intent} 클래스는 표준화된 데이터 유형에 대해 수많은 {@code EXTRA_*} 상수를 +지정합니다. 나름의 추가 키를 선언해야 하는 경우(본인의 앱이 수신할 +인텐트에 대하여), 앱의 패키지 이름을 접두사로 포함시커야 합니다. 예:</p> <pre>static final String EXTRA_GIGAWATTS = "com.example.EXTRA_GIGAWATTS";</pre> </dd> <dt><b>플래그</b></dt> -<dd>{@link android.content.Intent} 클래스에서 정의된 플래그로, 인텐트에 대한 메타데이터와 같은 기능을 -합니다. 이런 플래그는 Android 시스템에 액티비티를 시작할 방법에 대한 지침을 줄 수도 있고(예를 들어 액티비티가 어느 +<dd>{@link android.content.Intent} 클래스에서 정의된 플래그로, 인텐트에 대한 메타데이터와 같은 기능을 +합니다. 이런 플래그는 Android 시스템에 액티비티를 시작할 방법에 대한 지침을 줄 수도 있고(예를 들어 액티비티가 어느 <a href="{@docRoot}guide/components/tasks-and-back-stack.html">작업</a>에 소속되어야 하는지 등) - 액티비티를 시작한 다음에 어떻게 처리해야 하는지도 알려줄 수 있습니다(예를 들어 해당 액티비티가 최근 + 액티비티를 시작한 다음에 어떻게 처리해야 하는지도 알려줄 수 있습니다(예를 들어 해당 액티비티가 최근 액티비티 목록에 소속되는지 여부). <p>자세한 정보는 {@link android.content.Intent#setFlags setFlags()} 메서드를 참조하십시오.</p> @@ -318,12 +318,12 @@ android.content.Intent#putExtras putExtras()}로 삽입해도 됩니다.</p> <h3 id="ExampleExplicit">명시적 인텐트 예시</h3> -<p>명시적 인텐트는 특정한 앱 구성 요소를 시작하기 위해 사용하는 것입니다. 예를 들어 앱 내의 -특정 액티비티나 서비스를 말합니다. 명시적 인텐트를 생성하려면 -{@link android.content.Intent} 객체에 대한 구성 요소 이름을 정의합니다. 다른 +<p>명시적 인텐트는 특정한 앱 구성 요소를 시작하기 위해 사용하는 것입니다. 예를 들어 앱 내의 +특정 액티비티나 서비스를 말합니다. 명시적 인텐트를 생성하려면 +{@link android.content.Intent} 객체에 대한 구성 요소 이름을 정의합니다. 다른 인텐트 속성은 모두 선택 사항입니다.</p> -<p>예를 들어 앱 안에 {@code DownloadService}라는 서비스를 구축했다고 합시다. +<p>예를 들어 앱 안에 {@code DownloadService}라는 서비스를 구축했다고 합시다. 이 서비스는 웹 상에서 파일을 다운로드하도록 설계된 것입니다. 이것을 시작하려면 다음과 같은 코드를 사용하면 됩니다.</p> <pre> @@ -335,11 +335,11 @@ startService(downloadIntent); </pre> <p>{@link android.content.Intent#Intent(Context,Class)} - 생성자가 앱에 {@link android.content.Context}를 제공하고 -구성 요소에 {@link java.lang.Class} 객체를 제공합니다. 이처럼, + 생성자가 앱에 {@link android.content.Context}를 제공하고 +구성 요소에 {@link java.lang.Class} 객체를 제공합니다. 이처럼, 이 인텐트는 앱 내의 {@code DownloadService} 클래스를 명시적으로 시작합니다.</p> -<p>서비스를 구축하고 시작하는 데 대한 자세한 정보는 +<p>서비스를 구축하고 시작하는 데 대한 자세한 정보는 <a href="{@docRoot}guide/components/services.html">서비스</a> 가이드를 참조하십시오.</p> @@ -347,24 +347,24 @@ startService(downloadIntent); <h3 id="ExampleSend">암시적 인텐트 예시</h3> -<p>암시적 인텐트는 작업을 지정하여 기기에서 해당 작업을 수행할 수 있는 모든 앱을 호출할 수 -있도록 합니다. 암시적 인텐트를 사용하면 본인의 앱은 작업을 수행할 수 없지만 다른 앱은 아마도 할 수 있을 때, +<p>암시적 인텐트는 작업을 지정하여 기기에서 해당 작업을 수행할 수 있는 모든 앱을 호출할 수 +있도록 합니다. 암시적 인텐트를 사용하면 본인의 앱은 작업을 수행할 수 없지만 다른 앱은 아마도 할 수 있을 때, 그리고 사용자로 하여금 어느 앱을 사용할지 선택하도록 하고자 할 때 유용합니다.</p> -<p>예를 들어 사용자가 다른 사람들과 공유했으면 하는 콘텐츠를 가지고 있는 경우, -{@link android.content.Intent#ACTION_SEND} 작업이 있는 인텐트를 생성한 다음 -공유할 콘텐츠를 지정하는 추가 정보를 추가하면 됩니다. 해당 인텐트로 -{@link android.content.Context#startActivity startActivity()}를 호출하면 +<p>예를 들어 사용자가 다른 사람들과 공유했으면 하는 콘텐츠를 가지고 있는 경우, +{@link android.content.Intent#ACTION_SEND} 작업이 있는 인텐트를 생성한 다음 +공유할 콘텐츠를 지정하는 추가 정보를 추가하면 됩니다. 해당 인텐트로 +{@link android.content.Context#startActivity startActivity()}를 호출하면 사용자가 어느 앱을 통해 콘텐츠를 공유할지 선택할 수 있습니다.</p> <p class="caution"><strong>주의:</strong> 개발자가 {@link android.content.Context#startActivity startActivity()}로 전송한 암시적 인텐트를 처리할 앱이 사용자에게 <em>전혀</em> -표시되지 않을 수도 있습니다. 이런 일이 발생하면, 호출이 실패하고 앱 작동이 중단됩니다. 어느 액티비티든 +표시되지 않을 수도 있습니다. 이런 일이 발생하면, 호출이 실패하고 앱 작동이 중단됩니다. 어느 액티비티든 이 인텐트를 수신하도록 확실히 하려면, {@link android.content.Intent} 객체의 {@link android.content.Intent#resolveActivity -resolveActivity()}를 호출합니다. 결과가 null이 아닌 경우, -인텐트를 처리할 수 있는 앱이 최소한 하나는 있다는 뜻이며 -{@link android.content.Context#startActivity startActivity()}를 호출해도 안전합니다. 결과가 null이면, -해당 인텐트를 사용해서는 안 되며 가능한 경우 해당 인텐트를 발생시키는 기능을 비활성화해야 +resolveActivity()}를 호출합니다. 결과가 null이 아닌 경우, +인텐트를 처리할 수 있는 앱이 최소한 하나는 있다는 뜻이며 +{@link android.content.Context#startActivity startActivity()}를 호출해도 안전합니다. 결과가 null이면, +해당 인텐트를 사용해서는 안 되며 가능한 경우 해당 인텐트를 발생시키는 기능을 비활성화해야 합니다.</p> @@ -373,9 +373,7 @@ resolveActivity()}를 호출합니다. 결과가 null이 아닌 경우, Intent sendIntent = new Intent(); sendIntent.setAction(Intent.ACTION_SEND); sendIntent.putExtra(Intent.EXTRA_TEXT, textMessage); -sendIntent.setType({@link - org.apache.http.protocol.HTTP#PLAIN_TEXT_TYPE - HTTP.PLAIN_TEXT_TYPE}); // "text/plain" MIME type +sendIntent.setType("text/plain"); // Verify that the intent will resolve to an activity if (sendIntent.resolveActivity(getPackageManager()) != null) { @@ -383,15 +381,15 @@ if (sendIntent.resolveActivity(getPackageManager()) != null) { } </pre> -<p class="note"><strong>참고:</strong> 이 경우에서는 URI를 사용하지 않았지만 인텐트의 데이터 유형이 정의되어 +<p class="note"><strong>참고:</strong> 이 경우에서는 URI를 사용하지 않았지만 인텐트의 데이터 유형이 정의되어 추가 정보가 담고 있는 콘텐츠를 지정하였습니다.</p> -<p>{@link android.content.Context#startActivity startActivity()}를 호출하면 시스템이 +<p>{@link android.content.Context#startActivity startActivity()}를 호출하면 시스템이 설치된 앱을 모두 살펴보고 이런 종류의 인텐트를 처리할 수 있는 앱이 어느 것인지 알아봅니다( {@link android.content.Intent#ACTION_SEND} 작업이 있는 인텐트이며 "텍스트/일반" -데이터가 담긴 것). 이것을 처리할 수 있는 앱이 하나뿐이면, 해당 앱이 즉시 열리고 이 앱에 인텐트가 -주어집니다. 인텐트를 허용하는 액티비티가 여러 개인 경우, 시스템은 +데이터가 담긴 것). 이것을 처리할 수 있는 앱이 하나뿐이면, 해당 앱이 즉시 열리고 이 앱에 인텐트가 +주어집니다. 인텐트를 허용하는 액티비티가 여러 개인 경우, 시스템은 대화를 표시하여 사용자가 어느 앱을 사용할지 직접 선택할 수 있게 합니다.</p> @@ -402,17 +400,17 @@ if (sendIntent.resolveActivity(getPackageManager()) != null) { <h3 id="ForceChooser">앱 선택기 강제 적용하기</h3> -<p>암시적 인텐트에 응답하는 앱이 하나 이상인 경우, -사용자가 어느 앱을 사용할지 선택할 수 있으며 해당 앱을 이 작업에 대한 기본 선택으로 만들 수 -있습니다. 이는 사용자가 이제부터 계속 같은 앱을 사용하고자 할 것이라고 추정되는 작업을 -수행할 때 좋습니다. 예를 들어 웹 페이지를 열 때가 이에 해당됩니다(대다수 사용자가 +<p>암시적 인텐트에 응답하는 앱이 하나 이상인 경우, +사용자가 어느 앱을 사용할지 선택할 수 있으며 해당 앱을 이 작업에 대한 기본 선택으로 만들 수 +있습니다. 이는 사용자가 이제부터 계속 같은 앱을 사용하고자 할 것이라고 추정되는 작업을 +수행할 때 좋습니다. 예를 들어 웹 페이지를 열 때가 이에 해당됩니다(대다수 사용자가 웹 브라우저는 하나만 사용하는 것을 선호합니다).</p> -<p>그러나, 인텐트에 응답할 수 있는 앱이 여러 개이고 사용자가 매번 다른 앱을 사용하기를 원할 수도 있는 +<p>그러나, 인텐트에 응답할 수 있는 앱이 여러 개이고 사용자가 매번 다른 앱을 사용하기를 원할 수도 있는 경우라면, 선택기 대화를 명시적으로 표시해야 합니다. 선택기 대화 상자는 사용자가 작업에 사용할 앱을 매번 선택하도록 물어봅니다(사용자는 작업에 사용할 기본 앱을 선택할 수 없습니다). 예를 들어 앱이 {@link -android.content.Intent#ACTION_SEND} 작업에 "공유"를 수행하는 경우, 사용자는 각자의 현재 상황에 따라 여러 가지 다른 앱을 사용하여 공유하기를 +android.content.Intent#ACTION_SEND} 작업에 "공유"를 수행하는 경우, 사용자는 각자의 현재 상황에 따라 여러 가지 다른 앱을 사용하여 공유하기를 원할 수도 있습니다. 따라서 항상 선택기 대화를 사용해야 합니다(그림 2 참조).</p> @@ -452,53 +450,53 @@ android.content.Intent#createChooser createChooser()} 메서드에 전달된 인 <h2 id="Receiving">암시적 인텐트 수신하기</h2> -<p>본인의 앱이 수신할 수 있는 암시적 인텐트가 어느 것인지 알리려면, +<p>본인의 앱이 수신할 수 있는 암시적 인텐트가 어느 것인지 알리려면, 각 앱 구성 요소에 대한 하나 이상의 인텐트 필터를 <a href="{@docRoot}guide/topics/manifest/intent-filter-element.html">{@code <intent-filter>}</a> - 요소로 <a href="{@docRoot}guide/topics/manifest/manifest-intro.html">매니페스트 파일</a>에 선언합니다. -각 인텐트 필터가 인텐트의 작업, 데이터 및 카테고리를 근거로 어느 유형의 인텐트를 -허용하는지 나타냅니다. 시스템이 앱 구성 요소에 암시적 인텐트를 전달하는 것은 인텐트가 개발자의 인텐트 필터 중 하나를 + 요소로 <a href="{@docRoot}guide/topics/manifest/manifest-intro.html">매니페스트 파일</a>에 선언합니다. +각 인텐트 필터가 인텐트의 작업, 데이터 및 카테고리를 근거로 어느 유형의 인텐트를 +허용하는지 나타냅니다. 시스템이 앱 구성 요소에 암시적 인텐트를 전달하는 것은 인텐트가 개발자의 인텐트 필터 중 하나를 통과해 지나갈 수 있는 경우뿐입니다.</p> -<p class="note"><strong>참고:</strong> 명시적 인텐트는 항상 자신의 대상에 전달되며, +<p class="note"><strong>참고:</strong> 명시적 인텐트는 항상 자신의 대상에 전달되며, 이는 구성 요소가 어떤 인텐트 필터를 선언하든 무관합니다.</p> <p>앱 구성 요소는 자신이 수행할 수 있는 각 고유한 작업에 대해 별도의 필터를 선언해야 합니다. -예를 들어 이미지 갤러리 앱에 있는 한 액티비티에 두 개의 필터가 있을 수 있습니다. 필터 하나는 -이미지를 보고, 또 다른 필터는 이미지를 편집하는 것입니다. 액티비티가 시작되면, 이는 -{@link android.content.Intent}를 검사한 다음 +예를 들어 이미지 갤러리 앱에 있는 한 액티비티에 두 개의 필터가 있을 수 있습니다. 필터 하나는 +이미지를 보고, 또 다른 필터는 이미지를 편집하는 것입니다. 액티비티가 시작되면, 이는 +{@link android.content.Intent}를 검사한 다음 {@link android.content.Intent}에 있는 정보를 근거로 어떻게 동작할 것인지 결정합니다(편집기 제어 항목을 표시할 것인지 말 것인지 등).</p> <p>각 인텐트 필터는 앱의 매니페스트 파일에 있는 <a href="{@docRoot}guide/topics/manifest/intent-filter-element.html">{@code <intent-filter>}</a> -요소가 정의하며, 이는 상응하는 앱 구성 요소에 중첩되어 +요소가 정의하며, 이는 상응하는 앱 구성 요소에 중첩되어 있습니다(예: <a href="{@docRoot}guide/topics/manifest/activity-element.html">{@code <activity>}</a> -요소). <a href="{@docRoot}guide/topics/manifest/intent-filter-element.html">{@code <intent-filter>}</a> 내부에서는 -다음과 같은 세 가지 요소 중 하나 이상을 사용하여 허용할 인텐트 유형을 지정할 수 +요소). <a href="{@docRoot}guide/topics/manifest/intent-filter-element.html">{@code <intent-filter>}</a> 내부에서는 +다음과 같은 세 가지 요소 중 하나 이상을 사용하여 허용할 인텐트 유형을 지정할 수 있습니다.</p> <dl> <dt><a href="{@docRoot}guide/topics/manifest/action-element.html">{@code <action>}</a></dt> - <dd>허용된 인텐트 작업을 {@code name} 속성에서 선언합니다. 이 값은 + <dd>허용된 인텐트 작업을 {@code name} 속성에서 선언합니다. 이 값은 어떤 작업의 리터럴 문자열 값이어야 하며, 클래스 상수가 아닙니다.</dd> <dt><a href="{@docRoot}guide/topics/manifest/data-element.html">{@code <data>}</a></dt> - <dd>허용된 데이터 유형을 선언합니다. 이때 -데이터 URI(<code>scheme</code>, <code>host</code>, <code>port</code>, + <dd>허용된 데이터 유형을 선언합니다. 이때 +데이터 URI(<code>scheme</code>, <code>host</code>, <code>port</code>, <code>path</code> 등)와 MIME 유형의 여러 가지 측면을 나타내는 하나 이상의 속성을 사용하는 방법을 씁니다.</dd> <dt><a href="{@docRoot}guide/topics/manifest/category-element.html">{@code <category>}</a></dt> - <dd>허용된 인텐트 카테고리를 {@code name} 속성에서 선언합니다. 이 값은 + <dd>허용된 인텐트 카테고리를 {@code name} 속성에서 선언합니다. 이 값은 어떤 작업의 리터럴 문자열 값이어야 하며, 클래스 상수가 아닙니다. - <p class="note"><strong>참고:</strong> 암시적 인텐트를 수신하려면 인텐트 필터 안에 + <p class="note"><strong>참고:</strong> 암시적 인텐트를 수신하려면 인텐트 필터 안에 -{@link android.content.Intent#CATEGORY_DEFAULT} 카테고리를 <strong>반드시 포함</strong>해야 합니다. -{@link android.app.Activity#startActivity startActivity()} 및 -{@link android.app.Activity#startActivityForResult startActivityForResult()} 메서드는 +{@link android.content.Intent#CATEGORY_DEFAULT} 카테고리를 <strong>반드시 포함</strong>해야 합니다. +{@link android.app.Activity#startActivity startActivity()} 및 +{@link android.app.Activity#startActivityForResult startActivityForResult()} 메서드는 모든 인텐트를 마치 {@link android.content.Intent#CATEGORY_DEFAULT} 카테고리를 선언한 것처럼 취급합니다. - 이 카테고리를 인텐트 필터에서 선언하지 않으면 액티비티에 어떤 암시적 인텐트도 + 이 카테고리를 인텐트 필터에서 선언하지 않으면 액티비티에 어떤 암시적 인텐트도 확인되지 않습니다.</p> </dd> </dl> -<p>예를 들어, 다음은 데이터 유형이 텍스트인 경우 +<p>예를 들어, 다음은 데이터 유형이 텍스트인 경우 {@link android.content.Intent#ACTION_SEND} 인텐트를 수신할 인텐트 필터가 있는 액티비티 선언입니다.</p> <pre> @@ -512,49 +510,49 @@ android.content.Intent#createChooser createChooser()} 메서드에 전달된 인 </pre> <p> -<a href="{@docRoot}guide/topics/manifest/action-element.html">{@code <action>}</a>, -<a href="{@docRoot}guide/topics/manifest/data-element.html">{@code <data>}</a> 또는 -<a href="{@docRoot}guide/topics/manifest/category-element.html">{@code <category>}</a>의 인스턴스가 하나 이상 포함된 필터를 생성해도 됩니다. -그렇게 하는 경우, 그저 해당 구성 요소가 그와 같은 필터 요소의 모든 조합을 처리할 수 있도록 +<a href="{@docRoot}guide/topics/manifest/action-element.html">{@code <action>}</a>, +<a href="{@docRoot}guide/topics/manifest/data-element.html">{@code <data>}</a> 또는 +<a href="{@docRoot}guide/topics/manifest/category-element.html">{@code <category>}</a>의 인스턴스가 하나 이상 포함된 필터를 생성해도 됩니다. +그렇게 하는 경우, 그저 해당 구성 요소가 그와 같은 필터 요소의 모든 조합을 처리할 수 있도록 확실히 하기만 하면 됩니다.</p> -<p>여러 가지 종류의 인텐트를 처리하고자 하되 특정 조합의 작업, 데이터 및 카테고리 유형으로만 한정하고자 한다면 +<p>여러 가지 종류의 인텐트를 처리하고자 하되 특정 조합의 작업, 데이터 및 카테고리 유형으로만 한정하고자 한다면 여러 가지 인텐트 필터를 생성해야 합니다.</p> <div class="sidebox-wrapper"> <div class="sidebox"> <h2>구성 요소로의 액세스 제한</h2> -<p>인텐트 필터를 사용하는 것은 다른 앱이 여러분의 구성 요소를 시작하지 못하도록 방지하기에 -안전한 방식은 아닙니다. 인텐트 필터는 구성 요소로 하여금 특정한 종류의 암시적 인텐트에만 -응답하도록 제한하기는 하지만, 다른 앱이 여러분의 앱 구성 요소를 시작할 가능성도 있습니다. +<p>인텐트 필터를 사용하는 것은 다른 앱이 여러분의 구성 요소를 시작하지 못하도록 방지하기에 +안전한 방식은 아닙니다. 인텐트 필터는 구성 요소로 하여금 특정한 종류의 암시적 인텐트에만 +응답하도록 제한하기는 하지만, 다른 앱이 여러분의 앱 구성 요소를 시작할 가능성도 있습니다. 해당 개발자가 여러분의 구성 요소 이름을 알아내는 경우 명시적 인텐트를 사용하면 됩니다. -구성 요소 중 하나를 시작하는 것은 <em>오직 본인 소유의 앱</em>으로 한정하는 것이 중요한 경우, 해당 구성 요소에 대하여 +구성 요소 중 하나를 시작하는 것은 <em>오직 본인 소유의 앱</em>으로 한정하는 것이 중요한 경우, 해당 구성 요소에 대하여 <a href="{@docRoot}guide/topics/manifest/activity-element.html#exported">{@code exported}</a> 속성을 {@code "false"}로 설정하십시오. </p> </div> </div> -<p>암시적 인텐트를 필터에 대해 테스트하려면 인텐트를 세 가지 요소에 대해 각기 +<p>암시적 인텐트를 필터에 대해 테스트하려면 인텐트를 세 가지 요소에 대해 각기 비교합니다. 인텐트가 구성 요소에 전달되려면 해당 인텐트는 세 개의 테스트를 모두 통과해야 합니다. -하나라도 일치하지 못하고 실패하면 Android 시스템이 해당 인텐트를 구성 요소에 전달하지 -않습니다. 그러나 구성 요소에는 여러 개의 인텐트 필터가 있을 수도 있으므로, 구성 요소의 +하나라도 일치하지 못하고 실패하면 Android 시스템이 해당 인텐트를 구성 요소에 전달하지 +않습니다. 그러나 구성 요소에는 여러 개의 인텐트 필터가 있을 수도 있으므로, 구성 요소의 필터 중 하나를 통과하지 않는 인텐트도 다른 필터를 통하면 성공할 수 있습니다. -시스템이 인텐트를 확인하는 방법에 대한 자세한 정보는 +시스템이 인텐트를 확인하는 방법에 대한 자세한 정보는 <a href="#Resolution">인텐트 확인</a>에 대해 다룬 아래 섹션에 제공되어 있습니다.</p> -<p class="caution"><strong>주의:</strong> 부주의로 다른 앱의 -{@link android.app.Service}를 실행하는 일을 피하려면, 항상 명시적 인텐트를 사용하여 본인의 서비스를 시작하고 서비스에 대한 +<p class="caution"><strong>주의:</strong> 부주의로 다른 앱의 +{@link android.app.Service}를 실행하는 일을 피하려면, 항상 명시적 인텐트를 사용하여 본인의 서비스를 시작하고 서비스에 대한 인텐트 필터는 선언하지 마십시오.</p> <p class="note"><strong>참고:</strong> -액티비티 전체에 대해 인텐트 필터를 매니페스트 파일에서 선언해야 합니다. +액티비티 전체에 대해 인텐트 필터를 매니페스트 파일에서 선언해야 합니다. 다만 브로드캐스트 수신기에 대한 필터의 경우 동적으로 등록할 수도 있습니다. {@link android.content.Context#registerReceiver(BroadcastReceiver, IntentFilter, String, Handler) registerReceiver()}를 호출하면 됩니다. 그런 다음 해당 수신기를 등록 해제하려면 {@link -android.content.Context#unregisterReceiver unregisterReceiver()}를 사용하십시오. 이렇게 하면 앱이 -실행되는 동안에 정해진 기간 동안 특정한 브로드캐스트에 대해 수신 대기할 수 +android.content.Context#unregisterReceiver unregisterReceiver()}를 사용하십시오. 이렇게 하면 앱이 +실행되는 동안에 정해진 기간 동안 특정한 브로드캐스트에 대해 수신 대기할 수 있습니다.</p> @@ -565,7 +563,7 @@ android.content.Context#unregisterReceiver unregisterReceiver()}를 사용하십 <h3 id="ExampleFilters">필터 예시</h3> -<p>몇 가지 인텐트 필터 동작에 대해 이해를 돕기 위해 소셜 공유 앱의 매니페스트 파일에서 +<p>몇 가지 인텐트 필터 동작에 대해 이해를 돕기 위해 소셜 공유 앱의 매니페스트 파일에서 가져온 다음 조각을 참조하십시오.</p> <pre> @@ -596,26 +594,26 @@ android.content.Context#unregisterReceiver unregisterReceiver()}를 사용하십 </activity> </pre> -<p>첫 번째 액티비티인 {@code MainActivity}는 앱의 주요 진입 지점입니다. 즉 이것이 +<p>첫 번째 액티비티인 {@code MainActivity}는 앱의 주요 진입 지점입니다. 즉 이것이 사용자가 시작 관리자 아이콘을 사용하여 앱을 처음 시작할 때 열리는 액티비티입니다.</p> <ul> - <li>{@link android.content.Intent#ACTION_MAIN} 작업은 + <li>{@link android.content.Intent#ACTION_MAIN} 작업은 이것이 주요 진입 지점이며 어느 인텐트 데이터도 기대하지 않는다는 것을 나타냅니다.</li> - <li>{@link android.content.Intent#CATEGORY_LAUNCHER} 카테고리는 -이 액티비티의 아이콘이 시스템의 앱 시작 관리자에 배치되어야 한다는 것을 나타냅니다. <a href="{@docRoot}guide/topics/manifest/activity-element.html">{@code <activity>}</a> 요소가 + <li>{@link android.content.Intent#CATEGORY_LAUNCHER} 카테고리는 +이 액티비티의 아이콘이 시스템의 앱 시작 관리자에 배치되어야 한다는 것을 나타냅니다. <a href="{@docRoot}guide/topics/manifest/activity-element.html">{@code <activity>}</a> 요소가 아이콘을 {@code icon}으로 지정하지 않은 경우, 시스템은 <a href="{@docRoot}guide/topics/manifest/application-element.html">{@code <application>}</a> 요소로부터 가져온 아이콘을 사용합니다.</li> </ul> <p>이들 두 가지가 함께 페어링되어야 액티비티가 앱 시작 관리자에 나타날 수 있습니다.</p> -<p>두 번째 액티비티인 {@code ShareActivity}는 텍스트와 미디어 콘텐츠 공유를 -용이하게 할 목적으로 만들어진 것입니다. 사용자가 {@code MainActivity}에서 이 액티비티를 향해 이동하다가 이 안에 진입할 수도 있지만, -두 가지 인텐트 필터 중 하나와 일치하는 암시적 인텐트를 발생시키는 또 다른 앱에서 {@code ShareActivity}에 직접 진입할 수도 +<p>두 번째 액티비티인 {@code ShareActivity}는 텍스트와 미디어 콘텐츠 공유를 +용이하게 할 목적으로 만들어진 것입니다. 사용자가 {@code MainActivity}에서 이 액티비티를 향해 이동하다가 이 안에 진입할 수도 있지만, +두 가지 인텐트 필터 중 하나와 일치하는 암시적 인텐트를 발생시키는 또 다른 앱에서 {@code ShareActivity}에 직접 진입할 수도 있습니다.</p> -<p class="note"><strong>참고:</strong> MIME 유형, 즉 +<p class="note"><strong>참고:</strong> MIME 유형, 즉 <a href="https://developers.google.com/panorama/android/">{@code -application/vnd.google.panorama360+jpg}</a>는 파노라마 사진을 나타내는 +application/vnd.google.panorama360+jpg}</a>는 파노라마 사진을 나타내는 특수 데이터 유형으로, 이것은 <a href="{@docRoot}reference/com/google/android/gms/panorama/package-summary.html">Google 파노라마</a> API로 처리할 수 있습니다.</p> @@ -634,49 +632,49 @@ application/vnd.google.panorama360+jpg}</a>는 파노라마 사진을 나타내 <h2 id="PendingIntent">보류 인텐트 사용하기</h2> <p>{@link android.app.PendingIntent} 객체는 {@link -android.content.Intent} 객체 주변을 감싸는 래퍼입니다. {@link android.app.PendingIntent}의 -기본 목적은 외래 애플리케이션에 권한을 허가하여 안에 들어 있는 -{@link android.content.Intent}를 +android.content.Intent} 객체 주변을 감싸는 래퍼입니다. {@link android.app.PendingIntent}의 +기본 목적은 외래 애플리케이션에 권한을 허가하여 안에 들어 있는 +{@link android.content.Intent}를 마치 본인 앱의 자체 프로세스에서 실행하는 것처럼 사용하게 하는 것입니다.</p> <p>보류 인텐트의 주요 사용 사례는 다음과 같습니다.</p> <ul> - <li>사용자가 여러분의 <a href="{@docRoot}guide/topics/ui/notifiers/notifications.html">알림</a>으로 -작업을 수행할 때 인텐트가 실행되도록 선언합니다(Android 시스템의 {@link android.app.NotificationManager}가 + <li>사용자가 여러분의 <a href="{@docRoot}guide/topics/ui/notifiers/notifications.html">알림</a>으로 +작업을 수행할 때 인텐트가 실행되도록 선언합니다(Android 시스템의 {@link android.app.NotificationManager}가 {@link android.content.Intent}를 실행합니다). - <li>사용자가 여러분의 -<a href="{@docRoot}guide/topics/appwidgets/index.html">앱 위젯</a>으로 + <li>사용자가 여러분의 +<a href="{@docRoot}guide/topics/appwidgets/index.html">앱 위젯</a>으로 작업을 수행할 때 인텐트가 실행되도록 선언합니다(메인 스크린 앱이 {@link android.content.Intent}를 실행합니다). - <li>향후 지정된 시간에 인텐트가 실행되도록 선언합니다(Android + <li>향후 지정된 시간에 인텐트가 실행되도록 선언합니다(Android 시스템의 {@link android.app.AlarmManager}가 {@link android.content.Intent}를 실행합니다). </ul> -<p>각 {@link android.content.Intent} 객체는 특정한 유형의 -앱 구성 요소가({@link android.app.Activity}, {@link android.app.Service} 또는 -{@link android.content.BroadcastReceiver}) 처리하도록 설계되어 있기 때문에, {@link android.app.PendingIntent}도 -같은 고려 사항을 염두에 두고 생성해야 합니다. 보류 인텐트를 사용하는 경우, 여러분의 앱은 +<p>각 {@link android.content.Intent} 객체는 특정한 유형의 +앱 구성 요소가({@link android.app.Activity}, {@link android.app.Service} 또는 +{@link android.content.BroadcastReceiver}) 처리하도록 설계되어 있기 때문에, {@link android.app.PendingIntent}도 +같은 고려 사항을 염두에 두고 생성해야 합니다. 보류 인텐트를 사용하는 경우, 여러분의 앱은 {@link android.content.Context#startActivity -startActivity()}와 같은 호출이 있는 앱을 실행하지 않게 됩니다. 대신 +startActivity()}와 같은 호출이 있는 앱을 실행하지 않게 됩니다. 대신 {@link android.app.PendingIntent}를 생성할 때 원래 의도한 구성 요소 유형을 선언해야 합니다. 이때 각각의 생성자 메서드를 호출하는 방법을 씁니다.</p> <ul> - <li>{@link android.app.Activity}를 시작하는 {@link android.content.Intent}의 경우, + <li>{@link android.app.Activity}를 시작하는 {@link android.content.Intent}의 경우, {@link android.app.PendingIntent#getActivity PendingIntent.getActivity()}</li> - <li>{@link android.app.Service}를 시작하는 {@link android.content.Intent}의 경우, + <li>{@link android.app.Service}를 시작하는 {@link android.content.Intent}의 경우, {@link android.app.PendingIntent#getService PendingIntent.getService()}</li> - <li>{@link android.content.BroadcastReceiver}를 시작하는 {@link android.content.Intent}의 경우, + <li>{@link android.content.BroadcastReceiver}를 시작하는 {@link android.content.Intent}의 경우, {@link android.app.PendingIntent#getBroadcast PendingIntent.getBroadcast()}</li> </ul> -<p>여러분의 앱이 다른 여러 앱에서 보류 인텐트를 <em>수신</em>하는 것이 아닌 한, -위의 메서드를 사용하여 {@link android.app.PendingIntent}를 생성하는 것이 아마도 여러분에게 필요한 유일한 +<p>여러분의 앱이 다른 여러 앱에서 보류 인텐트를 <em>수신</em>하는 것이 아닌 한, +위의 메서드를 사용하여 {@link android.app.PendingIntent}를 생성하는 것이 아마도 여러분에게 필요한 유일한 {@link android.app.PendingIntent} 메서드일 것입니다.</p> -<p>각 메서드는 현재 앱의 {@link android.content.Context}, 래핑하고자 하는 +<p>각 메서드는 현재 앱의 {@link android.content.Context}, 래핑하고자 하는 {@link android.content.Intent}와 인텐트의 적절한 사용 방식을 나타내는 하나 이상의 플래그(인텐트를 한 번 이상 사용할 수 있는지 등) 등을 취합니다.</p> -<p>보류 인텐트 사용에 관한 자세한 정보는 각 해당되는 사용 사례에 대한 문서에 +<p>보류 인텐트 사용에 관한 자세한 정보는 각 해당되는 사용 사례에 대한 문서에 제공되어 있습니다. 예를 들어 <a href="{@docRoot}guide/topics/ui/notifiers/notifications.html">알림</a> 및 <a href="{@docRoot}guide/topics/appwidgets/index.html">앱 위젯</a> API 가이드가 이에 해당됩니다.</p> @@ -689,7 +687,7 @@ startActivity()}와 같은 호출이 있는 앱을 실행하지 않게 됩니다 <h2 id="Resolution">인텐트 확인</h2> -<p>시스템이 액티비티를 시작하라는 암시적 인텐트를 수신하면, 시스템은 해당 인텐트에 대한 최선의 액티비티를 검색합니다. +<p>시스템이 액티비티를 시작하라는 암시적 인텐트를 수신하면, 시스템은 해당 인텐트에 대한 최선의 액티비티를 검색합니다. 이때 다음과 같은 세 가지 측면을 근거로 인텐트를 인텐트 필터에 비교해 보는 방법을 씁니다.</p> <ul> @@ -698,13 +696,13 @@ startActivity()}와 같은 호출이 있는 앱을 실행하지 않게 됩니다 <li>인텐트 카테고리 </ul> -<p>다음 섹션에서는 인텐트 필터가 앱의 매니페스트 파일에서 어떻게 선언되었는지와 관련하여 +<p>다음 섹션에서는 인텐트 필터가 앱의 매니페스트 파일에서 어떻게 선언되었는지와 관련하여 인텐트가 적절한 구성 요소에 일치되는 방식을 설명합니다.</p> <h3 id="ActionTest">작업 테스트</h3> -<p>허용된 인텐트 작업을 나타내려면 인텐트 필터는 0개 이상의 +<p>허용된 인텐트 작업을 나타내려면 인텐트 필터는 0개 이상의 <a href="{@docRoot}guide/topics/manifest/action-element.html">{@code <action>}</a> 요소를 선언할 수 있습니다. 예:</p> @@ -716,19 +714,19 @@ startActivity()}와 같은 호출이 있는 앱을 실행하지 않게 됩니다 </intent-filter> </pre> -<p>이 필터를 통과하려면 {@link android.content.Intent}에 +<p>이 필터를 통과하려면 {@link android.content.Intent}에 지정된 작업이 필터에 목록으로 나열된 작업 중 하나와 일치해야만 합니다.</p> -<p>필터에 목록으로 나열된 작업이 없는 경우, 인텐트가 일치될 대상이 아무것도 없으므로 -모든 인텐트가 테스트에 실패합니다. 그러나, {@link android.content.Intent}가 -작업을 지정하지 않는 경우, 테스트를 통과하게 됩니다(필터에 최소한 한 개 이상의 작업이 +<p>필터에 목록으로 나열된 작업이 없는 경우, 인텐트가 일치될 대상이 아무것도 없으므로 +모든 인텐트가 테스트에 실패합니다. 그러나, {@link android.content.Intent}가 +작업을 지정하지 않는 경우, 테스트를 통과하게 됩니다(필터에 최소한 한 개 이상의 작업이 들어있지 않은 한).</p> <h3 id="CategoryTest">카테고리 테스트</h3> -<p>허용된 인텐트 카테고리를 나타내려면 인텐트 필터는 0개 이상의 +<p>허용된 인텐트 카테고리를 나타내려면 인텐트 필터는 0개 이상의 <a href="{@docRoot}guide/topics/manifest/category-element.html">{@code <category>}</a> 요소를 선언할 수 있습니다. 예:</p> @@ -740,26 +738,26 @@ startActivity()}와 같은 호출이 있는 앱을 실행하지 않게 됩니다 </intent-filter> </pre> -<p>인텐트가 카테고리 테스트를 통과하려면 {@link android.content.Intent} 내의 -모든 카테고리가 필터 내의 카테고리에 일치해야 합니다. 이 반대로는 반드시 성립하지 않아도 됩니다. 인텐트 필터가 -{@link android.content.Intent}에서 지정된 것보다 더 많은 카테고리를 선언할 수도 있지만 그래도 +<p>인텐트가 카테고리 테스트를 통과하려면 {@link android.content.Intent} 내의 +모든 카테고리가 필터 내의 카테고리에 일치해야 합니다. 이 반대로는 반드시 성립하지 않아도 됩니다. 인텐트 필터가 +{@link android.content.Intent}에서 지정된 것보다 더 많은 카테고리를 선언할 수도 있지만 그래도 {@link android.content.Intent}는 통과합니다. 그러므로, 카테고리가 없는 인텐트라면 이 테스트를 항상 통과하는 것이 맞습니다. 이는 필터에 어떤 카테고리가 선언되어 있는지와는 무관합니다.</p> <p class="note"><strong>참고:</strong> -Android는 {@link android.content.Intent#CATEGORY_DEFAULT} 카테고리를 +Android는 {@link android.content.Intent#CATEGORY_DEFAULT} 카테고리를 {@link android.content.Context#startActivity startActivity()} 및 {@link android.app.Activity#startActivityForResult startActivityForResult()}에 전달된 모든 암시적 인텐트에 적용합니다. -따라서 액티비티가 암시적 인텐트를 수신하기를 원하는 경우, -그 인텐트 필터 내에 {@code "android.intent.category.DEFAULT"}에 대한 카테고리가 반드시 포함되어 있어야 합니다(이전의 +따라서 액티비티가 암시적 인텐트를 수신하기를 원하는 경우, +그 인텐트 필터 내에 {@code "android.intent.category.DEFAULT"}에 대한 카테고리가 반드시 포함되어 있어야 합니다(이전의 {@code <intent-filter>} 예시에서 표시된 내용 참조).</p> <h3 id="DataTest">데이터 테스트</h3> -<p>허용된 인텐트 데이터를 나타내려면 인텐트 필터는 0개 이상의 +<p>허용된 인텐트 데이터를 나타내려면 인텐트 필터는 0개 이상의 <a href="{@docRoot}guide/topics/manifest/data-element.html">{@code <data>}</a> 요소를 선언할 수 있습니다. 예:</p> @@ -772,8 +770,8 @@ android.app.Activity#startActivityForResult startActivityForResult()}에 전달 </pre> <p>각 <code><a href="{@docRoot}guide/topics/manifest/data-element.html"><data></a></code> -요소는 URI 구조와 데이터 유형(MIME 미디어 유형)을 나타낼 수 있습니다. URI의 각 부분에 대해 별도의 -속성—{@code scheme}, {@code host}, {@code port} +요소는 URI 구조와 데이터 유형(MIME 미디어 유형)을 나타낼 수 있습니다. URI의 각 부분에 대해 별도의 +속성—{@code scheme}, {@code host}, {@code port} 및 {@code path}—이 있습니다. </p> @@ -785,11 +783,11 @@ android.app.Activity#startActivityForResult startActivityForResult()}에 전달 <p style="margin-left: 2em">{@code content://com.example.project:200/folder/subfolder/etc}</p> -<p>이 URI에서 구성표는 {@code content}이고 호스트는 {@code com.example.project}, +<p>이 URI에서 구성표는 {@code content}이고 호스트는 {@code com.example.project}, 포트는 {@code 200}이며 경로는 {@code folder/subfolder/etc}입니다. </p> -<p>이와 같은 속성은 각각 <a href="{@docRoot}guide/topics/manifest/data-element.html">{@code <data>}</a> 요소에서 선택 항목이지만, +<p>이와 같은 속성은 각각 <a href="{@docRoot}guide/topics/manifest/data-element.html">{@code <data>}</a> 요소에서 선택 항목이지만, 이들 사이에 선형적 종속 관계가 있습니다.</p> <ul> <li>구성표가 지정되지 않으면 호스트가 무시됩니다.</li> @@ -797,51 +795,51 @@ android.app.Activity#startActivityForResult startActivityForResult()}에 전달 <li>구성표와 호스트가 둘 다 지정되지 않으면 경로가 무시됩니다.</li> </ul> -<p>인텐트 안의 URI가 필터 안의 URI 사양에 비교되는 경우, 이것은 필터 내에 포함된 URI의 +<p>인텐트 안의 URI가 필터 안의 URI 사양에 비교되는 경우, 이것은 필터 내에 포함된 URI의 몇몇 부분에만 비교되는 것입니다. 예:</p> <ul> - <li>필터가 구성표만 지정하는 경우, 해당 구성표가 있는 모든 URI가 필터와 + <li>필터가 구성표만 지정하는 경우, 해당 구성표가 있는 모든 URI가 필터와 일치합니다.</li> - <li>필터가 구성표와 권한은 지정하지만 경로는 지정하지 않는 경우, 같은 구성표와 권한이 있는 + <li>필터가 구성표와 권한은 지정하지만 경로는 지정하지 않는 경우, 같은 구성표와 권한이 있는 모든 URI가 경로와 관계 없이 필터를 통과합니다.</li> - <li>필터가 구성표, 권한과 경로를 지정하는 경우 같은 구성표, + <li>필터가 구성표, 권한과 경로를 지정하는 경우 같은 구성표, 권한과 경로가 있는 URI만 해당 필터를 통과합니다.</li> </ul> -<p class="note"><strong>참고:</strong> 경로 사양에는 경로 이름이 +<p class="note"><strong>참고:</strong> 경로 사양에는 경로 이름이 부분적으로만 일치하도록 요구하기 위해 와일드카드 별표(*)가 들어 있을 수 있습니다.</p> -<p>데이터 테스트는 인텐트 안의 URI와 MIME 유형 둘 모두를 필터 안에서 +<p>데이터 테스트는 인텐트 안의 URI와 MIME 유형 둘 모두를 필터 안에서 지정된 MIME 유형과 비교합니다. 규칙은 다음과 같습니다. </p> <ol type="a"> -<li>URI도 MIME 유형도 들어 있지 않은 인텐트가 테스트를 통과하는 것은 +<li>URI도 MIME 유형도 들어 있지 않은 인텐트가 테스트를 통과하는 것은 필터가 URI나 MIME 유형을 전혀 지정하지 않은 경우뿐입니다.</li> -<li>URI는 들어 있지만 MIME 유형은 없는 인텐트(URI로부터는 -명시적이지도 않고 추론할 수도 없음)가 테스트를 통과하는 것은 그 URI가 필터의 URI 형식과 일치하며 +<li>URI는 들어 있지만 MIME 유형은 없는 인텐트(URI로부터는 +명시적이지도 않고 추론할 수도 없음)가 테스트를 통과하는 것은 그 URI가 필터의 URI 형식과 일치하며 필터가 인텐트와 마찬가지로 MIME 유형을 지정하지 않는 경우뿐입니다.</li> -<li>MIME 유형은 들어 있지만 URI는 없는 인텐트가 테스트를 통과하는 것은 +<li>MIME 유형은 들어 있지만 URI는 없는 인텐트가 테스트를 통과하는 것은 해당 필터가 같은 MIME 유형을 목록으로 나열하지만 URI 형식은 지정하지 않은 경우뿐입니다.</li> -<li>URI와 MIME 유형이 둘 다 들어 있는 인텐트(URI로부터는 -명시적이지도 않고 추론할 수도 없음)가 테스트의 MIME 유형 부분을 통과하는 것은 해당 유형이 -필터 내에 목록으로 나열된 한 유형에 일치하는 경우뿐입니다. 이것이 테스트의 URI 부분을 통과하는 것은 +<li>URI와 MIME 유형이 둘 다 들어 있는 인텐트(URI로부터는 +명시적이지도 않고 추론할 수도 없음)가 테스트의 MIME 유형 부분을 통과하는 것은 해당 유형이 +필터 내에 목록으로 나열된 한 유형에 일치하는 경우뿐입니다. 이것이 테스트의 URI 부분을 통과하는 것은 URI가 필터 내의 URI와 일치하거나, {@code content:} - 또는 {@code file:} URI가 있고 필터가 URI를 지정하지 않은 경우뿐입니다. 달리 말하면, -구성 요소는 필터가 MIME 유형 <em>하나만</em> 목록으로 나열하는 경우 {@code content:} 및 {@code file:} 데이터를 + 또는 {@code file:} URI가 있고 필터가 URI를 지정하지 않은 경우뿐입니다. 달리 말하면, +구성 요소는 필터가 MIME 유형 <em>하나만</em> 목록으로 나열하는 경우 {@code content:} 및 {@code file:} 데이터를 지원하는 것으로 간주한다는 뜻입니다.</p></li> </ol> <p> -마지막 규칙인 규칙 (d)는 +마지막 규칙인 규칙 (d)는 구성 요소가 파일이나 콘텐츠 제공자로부터 로컬 파일을 가져올 수 있는지에 대한 기대 수준을 반영합니다. -따라서 이러한 필터는 데이터 유형만 목록으로 나열해도 되고, -{@code content:} 및 {@code file:} 구성표의 이름을 명시적으로 제시하지 않아도 됩니다. -이것이 일반적인 경우입니다. 예를 들어, 다음 예시와 같은 <a href="{@docRoot}guide/topics/manifest/data-element.html">{@code <data>}</a> 요소는 -Android에 구성 요소가 콘텐츠 제공자에서 이미지 데이터를 가져와 표시할 수 있다고 +따라서 이러한 필터는 데이터 유형만 목록으로 나열해도 되고, +{@code content:} 및 {@code file:} 구성표의 이름을 명시적으로 제시하지 않아도 됩니다. +이것이 일반적인 경우입니다. 예를 들어, 다음 예시와 같은 <a href="{@docRoot}guide/topics/manifest/data-element.html">{@code <data>}</a> 요소는 +Android에 구성 요소가 콘텐츠 제공자에서 이미지 데이터를 가져와 표시할 수 있다고 알립니다. </p> @@ -852,14 +850,14 @@ Android에 구성 요소가 콘텐츠 제공자에서 이미지 데이터를 가 </intent-filter></pre> <p> -대부분의 사용 가능한 데이터는 콘텐츠 제공자가 제공하는 것이므로, 데이터 유형은 +대부분의 사용 가능한 데이터는 콘텐츠 제공자가 제공하는 것이므로, 데이터 유형은 지정하지만 URI는 지정하지 않는 필터가 아마 가장 보편적인 유형일 것입니다. </p> <p> -또 다른 보편적인 구성을 예로 들자면 구성표와 데이터 유형을 가진 필터가 있겠습니다. 예를 들어 +또 다른 보편적인 구성을 예로 들자면 구성표와 데이터 유형을 가진 필터가 있겠습니다. 예를 들어 다음 예시와 같은 <a href="{@docRoot}guide/topics/manifest/data-element.html">{@code <data>}</a> - 요소는 Android에 구성 요소가 + 요소는 Android에 구성 요소가 작업을 수행하기 위해 네트워크에서 비디오 데이터를 검색할 수 있다고 알립니다. </p> @@ -873,25 +871,25 @@ Android에 구성 요소가 콘텐츠 제공자에서 이미지 데이터를 가 <h3 id="imatch">인텐트 일치</h3> -<p>인텐트를 인텐트 필터에 비교해 일치시키면 활성화할 대상 구성 요소를 -찾아낼 수 있을 뿐만 아니라, 기기에 있는 일련의 구성 요소에 대해 -무언가 알아낼 수도 있습니다. 예를 들어 홈 앱이 앱 시작 관리자를 채우려면 +<p>인텐트를 인텐트 필터에 비교해 일치시키면 활성화할 대상 구성 요소를 +찾아낼 수 있을 뿐만 아니라, 기기에 있는 일련의 구성 요소에 대해 +무언가 알아낼 수도 있습니다. 예를 들어 홈 앱이 앱 시작 관리자를 채우려면 -{@link android.content.Intent#ACTION_MAIN} 작업과 +{@link android.content.Intent#ACTION_MAIN} 작업과 {@link android.content.Intent#CATEGORY_LAUNCHER} 카테고리를 지정하는 인텐트 필터를 가진 액티비티를 모두 찾아야 합니다.</p> -<p>여러분의 애플리케이션도 인텐트 일치를 이와 비슷한 방식으로 사용할 수 있습니다. +<p>여러분의 애플리케이션도 인텐트 일치를 이와 비슷한 방식으로 사용할 수 있습니다. {@link android.content.pm.PackageManager}에는 {@code query...()} - 메서드 집합이 있어 특정 인텐트를 허용하는 구성 요소를 모두 반환할 수 있고, -이와 유사한 일련의 {@code resolve...()} 메서드도 있어 한 인텐트에 응답하는 데 -가장 좋은 구성 요소를 판별할 수 있습니다. 예를 들어, + 메서드 집합이 있어 특정 인텐트를 허용하는 구성 요소를 모두 반환할 수 있고, +이와 유사한 일련의 {@code resolve...()} 메서드도 있어 한 인텐트에 응답하는 데 +가장 좋은 구성 요소를 판별할 수 있습니다. 예를 들어, {@link android.content.pm.PackageManager#queryIntentActivities -queryIntentActivities()}는 인수로 통과한 +queryIntentActivities()}는 인수로 통과한 인텐트를 수행할 수 있는 모든 액티비티의 목록을 반환하며 {@link android.content.pm.PackageManager#queryIntentServices -queryIntentServices()}는 이와 비슷한 서비스 목록을 반환합니다. -양쪽 메서드 모두 구성 요소를 활성화하지는 않습니다. 다만 응답할 수 있는 것들을 목록으로 -나열할 뿐입니다. 이와 비슷한 메서드인 +queryIntentServices()}는 이와 비슷한 서비스 목록을 반환합니다. +양쪽 메서드 모두 구성 요소를 활성화하지는 않습니다. 다만 응답할 수 있는 것들을 목록으로 +나열할 뿐입니다. 이와 비슷한 메서드인 {@link android.content.pm.PackageManager#queryBroadcastReceivers queryBroadcastReceivers()}는 브로드캐스트 수신기에 쓰입니다. </p> diff --git a/docs/html-intl/intl/ko/guide/topics/providers/contacts-provider.jd b/docs/html-intl/intl/ko/guide/topics/providers/contacts-provider.jd index 4f091264bc6b..94d3295c1d46 100644 --- a/docs/html-intl/intl/ko/guide/topics/providers/contacts-provider.jd +++ b/docs/html-intl/intl/ko/guide/topics/providers/contacts-provider.jd @@ -57,7 +57,7 @@ page.title=연락처 제공자 <li>{@link android.provider.ContactsContract.Contacts}</li> <li>{@link android.provider.ContactsContract.RawContacts}</li> <li>{@link android.provider.ContactsContract.Data}</li> - <li>{@link android.provider.ContactsContract.StreamItems}</li> + <li>{@code android.provider.ContactsContract.StreamItems}</li> </ol> <h2>관련 샘플</h2> <ol> @@ -169,7 +169,7 @@ Android 구성 요소입니다. 콘텐츠 제공자는 기기의 연락처 애 원시 연락처의 데이터 대부분은 {@link android.provider.ContactsContract.RawContacts} 테이블에 저장되지 않습니다. 대신, {@link android.provider.ContactsContract.Data} 테이블에서 하나 이상의 행에 저장됩니다. 각 데이터 행에는 -상위 {@link android.provider.ContactsContract.RawContacts} 행의 {@link android.provider.BaseColumns#_ID RawContacts._ID} 값을 포함하는 +상위 {@link android.provider.ContactsContract.RawContacts} 행의 {@code android.provider.BaseColumns#_ID RawContacts._ID} 값을 포함하는 열 {@link android.provider.ContactsContract.DataColumns#RAW_CONTACT_ID Data.RAW_CONTACT_ID}가 있습니다. </p> @@ -482,16 +482,16 @@ Email.CONTENT_ITEM_TYPE}을 갖는 </p> <p> {@link android.provider.ContactsContract.Contacts} 테이블에는 연락처 행에 대한 "영구" 링크인 -{@link android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} 열도 +{@code android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} 열도 있습니다. 연락처 제공자가 연락처를 자동으로 관리하므로, -통합이나 동기화에 응답하여 연락처 행의 {@link android.provider.BaseColumns#_ID} 값을 +통합이나 동기화에 응답하여 연락처 행의 {@code android.provider.BaseColumns#_ID} 값을 변경할 수도 있습니다. 이런 일이 발생한다 하더라도 콘텐츠 URI {@link android.provider.ContactsContract.Contacts#CONTENT_LOOKUP_URI}와 -연락처의 {@link android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY}는 여전히 +연락처의 {@code android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY}는 여전히 연락처 행을 가리키므로, -{@link android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY}를 +{@code android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY}를 사용하여 "즐겨찾기" 연락처에 대한 연결 등을 그대로 유지할 수 있습니다. 이 열에는 -{@link android.provider.BaseColumns#_ID} 열의 형식과 관련이 없는 나름의 형식이 있습니다. +{@code android.provider.BaseColumns#_ID} 열의 형식과 관련이 없는 나름의 형식이 있습니다. </p> <p> 그림 3은 세 가지 기본 테이블이 서로 관련되는 방식을 나타낸 것입니다. @@ -601,13 +601,13 @@ Google 계정과 같고, 이는 계정 이름으로 이메일 주소를 사용 사용자 프로필에 액세스하려면 특수 권한이 필요합니다. 읽기와 쓰기에 필요한 {@link android.Manifest.permission#READ_CONTACTS}와 {@link android.Manifest.permission#WRITE_CONTACTS} 권한 외에도, -사용자 프로필에 액세스하려면 각각 읽기와 쓰기 액세스를 위한{@link android.Manifest.permission#READ_PROFILE}과 -{@link android.Manifest.permission#WRITE_PROFILE} 권한이 +사용자 프로필에 액세스하려면 각각 읽기와 쓰기 액세스를 위한{@code android.Manifest.permission#READ_PROFILE}과 +{@code android.Manifest.permission#WRITE_PROFILE} 권한이 필요합니다. </p> <p> 사용자의 프로필은 중요한 정보로 간주해야 한다는 점을 명심하십시오. -{@link android.Manifest.permission#READ_PROFILE}권한을 사용하면 개발자가 기기 사용자의 +{@code android.Manifest.permission#READ_PROFILE}권한을 사용하면 개발자가 기기 사용자의 개인 식별 데이터에 액세스할 수 있게 해줍니다. 애플리케이션 설명에서 사용자에게 왜 여러분이 사용자 프로필 권한을 필요로 하는지 밝혀두어야 합니다. </p> @@ -978,7 +978,7 @@ onLoadFinished()}에 대한 콜백을 호출합니다. 이 메서드로 수신 새로운 원시 연락처 행과 관련 데이터 행을 일련의 {@link android.content.ContentProviderOperation} 개체로 삽입할 때는, 원시 연락처의 -{@link android.provider.BaseColumns#_ID} 값을 +{@code android.provider.BaseColumns#_ID} 값을 {@link android.provider.ContactsContract.DataColumns#RAW_CONTACT_ID} 값으로 삽입하여 데이터 행과 원시 연락처 행을 연결해야 합니다. 그러나, 이 값은 데이터 행에 대하여 {@link android.content.ContentProviderOperation}을 생성하는 경우에는 사용할 수 없습니다. 원시 연락처 행에 대해 {@link android.content.ContentProviderOperation} @@ -1011,7 +1011,7 @@ onLoadFinished()}에 대한 콜백을 호출합니다. 이 메서드로 수신 결과의 중간 배열에 저장됩니다. <code>previousResult</code> 값은 이러한 결과 중 하나의 색인이고, 이는 <code>key</code> 값으로 검색 및 저장됩니다. 이것을 사용하면 새 원시 연락처 레코드를 삽입하고 -{@link android.provider.BaseColumns#_ID} 값을 다시 가져온 뒤, +{@code android.provider.BaseColumns#_ID} 값을 다시 가져온 뒤, {@link android.provider.ContactsContract.Data} 행을 추가할 때 해당 값을 "역참조"할 수 있게 해줍니다. <p> @@ -1091,7 +1091,7 @@ protected void createContactEntry() { 사용하여 {@link android.provider.ContactsContract.DataColumns#RAW_CONTACT_ID}를 가져옵니다. 참조는 첫 번째 작업의 {@link android.content.ContentProviderResult} 객체를 다시 가리키고, -이것이 원시 연락처 행을 추가한 뒤 이의 새 {@link android.provider.BaseColumns#_ID} +이것이 원시 연락처 행을 추가한 뒤 이의 새 {@code android.provider.BaseColumns#_ID} 값을 반환합니다. 그 결과, 각 데이터 행은 자동으로 자신의 {@link android.provider.ContactsContract.DataColumns#RAW_CONTACT_ID} 에 의해 자신이 속하는 새 {@link android.provider.ContactsContract.RawContacts} 행에 연결됩니다. @@ -1231,7 +1231,7 @@ withYieldAllowed()}로 플래그 표시합니다. {@link android.content.ContentProviderOperation#newAssertQuery(Uri)} 메서드를 사용합니다. 콘텐츠 URI의 경우, {@link android.provider.ContactsContract.RawContacts#CONTENT_URI RawContacts.CONTENT_URI}를 사용하되 -이에 추가된 원시 데이터의 {@link android.provider.BaseColumns#_ID}를 함께 씁니다. +이에 추가된 원시 데이터의 {@code android.provider.BaseColumns#_ID}를 함께 씁니다. </li> <li> {@link android.content.ContentProviderOperation.Builder} 개체의 경우, @@ -1821,8 +1821,8 @@ XML 파일 <code>res/xml/syncadapter.xml</code>을 가리킵니다. 그런가 </dl> <h2 id="SocialStream">소셜 스트림 데이터</h2> <p> - {@link android.provider.ContactsContract.StreamItems}와 -{@link android.provider.ContactsContract.StreamItemPhotos} 테이블은 + {@code android.provider.ContactsContract.StreamItems}와 +{@code android.provider.ContactsContract.StreamItemPhotos} 테이블은 소셜 네트워크에서 수신하는 데이터를 관리합니다. 개발자는 본인의 네트워크의 스트림 데이터를 이 테이블에 추가하는 동기화 어댑터를 작성할 수도 있고, 이 테이블에서 스트림 데이터를 읽어서 본인의 애플리케이션에 표시할 수도 있으며 두 가지를 모두 해도 됩니다. 이 기능을 사용하면 소셜 네트워킹 @@ -1831,7 +1831,7 @@ XML 파일 <code>res/xml/syncadapter.xml</code>을 가리킵니다. 그런가 <h3 id="StreamText">소셜 스트림 텍스트</h3> <p> 스트림 항목은 항상 원시 연락처와 연관됩니다. -{@link android.provider.ContactsContract.StreamItemsColumns#RAW_CONTACT_ID}는 +{@code android.provider.ContactsContract.StreamItemsColumns#RAW_CONTACT_ID}는 원시 연락처의 <code>_ID</code> 값과 연관됩니다. 원시 연락처의 계정 유형과 계정 이름도 스트림 항목 행에 저장됩니다. </p> @@ -1840,14 +1840,14 @@ XML 파일 <code>res/xml/syncadapter.xml</code>을 가리킵니다. 그런가 </p> <dl> <dt> - {@link android.provider.ContactsContract.StreamItemsColumns#ACCOUNT_TYPE} + {@code android.provider.ContactsContract.StreamItemsColumns#ACCOUNT_TYPE} </dt> <dd> <strong>필수입니다.</strong> 이 스트림 항목과 연관된 원시 연락처에 대한 사용자 계정입니다. 스트림 항목을 삽입할 때 이 값을 설정하는 것을 잊지 마십시오. </dd> <dt> - {@link android.provider.ContactsContract.StreamItemsColumns#ACCOUNT_NAME} + {@code android.provider.ContactsContract.StreamItemsColumns#ACCOUNT_NAME} </dt> <dd> <strong>필수입니다.</strong> 이 스트림 항목과 연관된 원시 연락처에 대한 @@ -1861,30 +1861,30 @@ XML 파일 <code>res/xml/syncadapter.xml</code>을 가리킵니다. 그런가 다음 식별자 열을 삽입해야 합니다. <ul> <li> - {@link android.provider.ContactsContract.StreamItemsColumns#CONTACT_ID}: 이 -스트림 항목과 연관된 연락처의 {@link android.provider.BaseColumns#_ID} + {@code android.provider.ContactsContract.StreamItemsColumns#CONTACT_ID}: 이 +스트림 항목과 연관된 연락처의 {@code android.provider.BaseColumns#_ID} 값입니다. </li> <li> - {@link android.provider.ContactsContract.StreamItemsColumns#CONTACT_LOOKUP_KEY}: 이 -스트림 항목과 연관된 연락처의 {@link android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} + {@code android.provider.ContactsContract.StreamItemsColumns#CONTACT_LOOKUP_KEY}: 이 +스트림 항목과 연관된 연락처의 {@code android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} 값입니다. </li> <li> - {@link android.provider.ContactsContract.StreamItemsColumns#RAW_CONTACT_ID}: 이 -스트림 항목과 연관된 원시 연락처의 {@link android.provider.BaseColumns#_ID} + {@code android.provider.ContactsContract.StreamItemsColumns#RAW_CONTACT_ID}: 이 +스트림 항목과 연관된 원시 연락처의 {@code android.provider.BaseColumns#_ID} 값입니다. </li> </ul> </dd> <dt> - {@link android.provider.ContactsContract.StreamItemsColumns#COMMENTS} + {@code android.provider.ContactsContract.StreamItemsColumns#COMMENTS} </dt> <dd> 선택 사항입니다. 스트림 항목의 시작 부분에 표시할 수 있는 요약 정보를 저장합니다. </dd> <dt> - {@link android.provider.ContactsContract.StreamItemsColumns#TEXT} + {@code android.provider.ContactsContract.StreamItemsColumns#TEXT} </dt> <dd> 스트림 항목의 텍스트로, 항목의 소스가 게시한 콘텐츠 또는 @@ -1894,7 +1894,7 @@ XML 파일 <code>res/xml/syncadapter.xml</code>을 가리킵니다. 그런가 자르거나 생략할 수 있지만, 가능하면 태그를 손상시키는 것은 피하려 듭니다. </dd> <dt> - {@link android.provider.ContactsContract.StreamItemsColumns#TIMESTAMP} + {@code android.provider.ContactsContract.StreamItemsColumns#TIMESTAMP} </dt> <dd> 스트림 항목이 삽입되거나 업데이트된 시간이 들어있는 텍스트 문자열로, 형식은 @@ -1905,42 +1905,42 @@ epoch 이후 <em>밀리초</em> 형태를 취합니다. 이 열을 관리할 책 </dl> <p> 스트림 항목의 식별 정보를 표시하려면 -{@link android.provider.ContactsContract.StreamItemsColumns#RES_ICON}, -{@link android.provider.ContactsContract.StreamItemsColumns#RES_LABEL}, -{@link android.provider.ContactsContract.StreamItemsColumns#RES_PACKAGE}를 사용하여 애플리케이션에서 +{@code android.provider.ContactsContract.StreamItemsColumns#RES_ICON}, +{@code android.provider.ContactsContract.StreamItemsColumns#RES_LABEL}, +{@code android.provider.ContactsContract.StreamItemsColumns#RES_PACKAGE}를 사용하여 애플리케이션에서 리소스를 연결하십시오. </p> <p> - {@link android.provider.ContactsContract.StreamItems} 테이블에도 -동기화 어댑터가 독점적으로 사용하는 {@link android.provider.ContactsContract.StreamItemsColumns#SYNC1}에서 -{@link android.provider.ContactsContract.StreamItemsColumns#SYNC4}까지의 열이 + {@code android.provider.ContactsContract.StreamItems} 테이블에도 +동기화 어댑터가 독점적으로 사용하는 {@code android.provider.ContactsContract.StreamItemsColumns#SYNC1}에서 +{@code android.provider.ContactsContract.StreamItemsColumns#SYNC4}까지의 열이 들어있습니다. </p> <h3 id="StreamPhotos">소셜 스트림 사진</h3> <p> - {@link android.provider.ContactsContract.StreamItemPhotos} 테이블은 스트림 항목과 연관된 + {@code android.provider.ContactsContract.StreamItemPhotos} 테이블은 스트림 항목과 연관된 사진을 저장합니다. 테이블의 -{@link android.provider.ContactsContract.StreamItemPhotosColumns#STREAM_ITEM_ID} 열은 -{@link android.provider.ContactsContract.StreamItems} 테이블의 {@link android.provider.BaseColumns#_ID} 열에 있는 값과 +{@code android.provider.ContactsContract.StreamItemPhotosColumns#STREAM_ITEM_ID} 열은 +{@code android.provider.ContactsContract.StreamItems} 테이블의 {@code android.provider.BaseColumns#_ID} 열에 있는 값과 연결됩니다. 사진 참조는 다음 열의 테이블에 저장됩니다. </p> <dl> <dt> - {@link android.provider.ContactsContract.StreamItemPhotos#PHOTO} 열(BLOB). + {@code android.provider.ContactsContract.StreamItemPhotos#PHOTO} 열(BLOB). </dt> <dd> 사진의 바이너리 표현으로, 제공자가 저장하고 표시하기 위해 크기를 조정한 것입니다. 이 열은 사진을 저장하는 데 사용한 연락처 제공자의 이전 버전과 호환됩니다. 그러나 현재 버전에서는 이 열을 사진 저장에 사용하면 안 됩니다. 대신, -{@link android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_FILE_ID} 또는 -{@link android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_URI}( +{@code android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_FILE_ID} 또는 +{@code android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_URI}( 다음 항목에서 두 가지 모두 설명)를 사용하여 사진을 파일로 저장합니다. 지금 이 열에는 사진의 미리 보기가 들어있어 읽기 작업에 사용할 수 있습니다. </dd> <dt> - {@link android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_FILE_ID} + {@code android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_FILE_ID} </dt> <dd> 원시 연락처에 대한 사진의 숫자 식별자입니다. 이 값을 @@ -1950,7 +1950,7 @@ epoch 이후 <em>밀리초</em> 형태를 취합니다. 이 열을 관리할 책 openAssetFileDescriptor()}를 호출하여 사진 파일에 대한 핸들을 가져옵니다. </dd> <dt> - {@link android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_URI} + {@code android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_URI} </dt> <dd> 이 행이 나타내는 사진에 대한 사진 파일을 직접 가리키는 콘텐츠 URI입니다. @@ -1965,27 +1965,27 @@ openAssetFileDescriptor()}를 호출하면 사진 파일에 대한 핸들을 가 <ul> <li> 이 테이블에는 추가 액세스 권한이 필요합니다. 여기서 읽기 작업을 수행하려면 애플리케이션에 -{@link android.Manifest.permission#READ_SOCIAL_STREAM} 권한이 있어야 합니다. 여기서 수정 작업을 수행하려면 +{@code android.Manifest.permission#READ_SOCIAL_STREAM} 권한이 있어야 합니다. 여기서 수정 작업을 수행하려면 애플리케이션에 -{@link android.Manifest.permission#WRITE_SOCIAL_STREAM} 권한이 있어야 합니다. +{@code android.Manifest.permission#WRITE_SOCIAL_STREAM} 권한이 있어야 합니다. </li> <li> - {@link android.provider.ContactsContract.StreamItems} 테이블의 경우, 각 원시 연락처에 저장되는 + {@code android.provider.ContactsContract.StreamItems} 테이블의 경우, 각 원시 연락처에 저장되는 행 개수가 제한되어 있습니다. 이 한계에 도달하면, 연락처 제공자가 새 스트림 항목 열에 필요한 공간을 만들어야 합니다. -이때 가장 오래된 {@link android.provider.ContactsContract.StreamItemsColumns#TIMESTAMP}가 +이때 가장 오래된 {@code android.provider.ContactsContract.StreamItemsColumns#TIMESTAMP}가 있는 행부터 자동으로 삭제하는 방법을 씁니다. 이 한계를 가져오려면, 콘텐츠 URI -{@link android.provider.ContactsContract.StreamItems#CONTENT_LIMIT_URI}에 쿼리를 발행합니다. 콘텐츠 +{@code android.provider.ContactsContract.StreamItems#CONTENT_LIMIT_URI}에 쿼리를 발행합니다. 콘텐츠 URI를 뺀 나머지 모든 인수는 <code>null</code>로 설정한 채 두면 됩니다. 이 쿼리는 행이 하나 들어 있는 커서를 반환하며, -{@link android.provider.ContactsContract.StreamItems#MAX_ITEMS} 열 하나가 수반됩니다. +{@code android.provider.ContactsContract.StreamItems#MAX_ITEMS} 열 하나가 수반됩니다. </li> </ul> <p> - {@link android.provider.ContactsContract.StreamItems.StreamItemPhotos} 클래스는 -스트림 항목 하나의 사진 행을 포함하는 {@link android.provider.ContactsContract.StreamItemPhotos}의 + {@code android.provider.ContactsContract.StreamItems.StreamItemPhotos} 클래스는 +스트림 항목 하나의 사진 행을 포함하는 {@code android.provider.ContactsContract.StreamItemPhotos}의 하위 테이블을 정의합니다. </p> <h3 id="SocialStreamInteraction">소셜 스트림 상호 작용</h3> @@ -1998,8 +1998,8 @@ URI를 뺀 나머지 모든 인수는 <code>null</code>로 설정한 채 두면 <li> 소셜 네트워킹 서비스를 동기화 어댑터로 연락처 제공자에 동기화함으로써, 사용자 연락처의 최근 활동을 검색하고 이를 -{@link android.provider.ContactsContract.StreamItems} 및 -{@link android.provider.ContactsContract.StreamItemPhotos} 테이블에 저장해 두어 나중에 사용할 수 있습니다. +{@code android.provider.ContactsContract.StreamItems} 및 +{@code android.provider.ContactsContract.StreamItemPhotos} 테이블에 저장해 두어 나중에 사용할 수 있습니다. </li> <li> 정기 동기화 외에도 사용자가 볼 연락처를 선택하면 동기화 어댑터를 트리거하여 @@ -2330,7 +2330,7 @@ Settings.UNGROUPED_VISIBLE} 열의 값을 1로 설정합니다. 이렇게 하면 {@link android.provider.ContactsContract.CommonDataKinds.Photo#CONTENT_ITEM_TYPE Photo.CONTENT_ITEM_TYPE} MIME 유형으로 사진을 행에 저장합니다. 이 행의 {@link android.provider.ContactsContract.RawContactsColumns#CONTACT_ID} 열은 -행이 속한 원시 연락처의 {@link android.provider.BaseColumns#_ID} 열과 연결됩니다. +행이 속한 원시 연락처의 {@code android.provider.BaseColumns#_ID} 열과 연결됩니다. 클래스 {@link android.provider.ContactsContract.Contacts.Photo}는 연락처 기본 사진의 사진 정보가 들어있는 {@link android.provider.ContactsContract.Contacts} 하위 테이블을 정의합니다. 연락처의 기본 사진은 연락처 기본 원시 연락처의 기본 사진입니다. 마찬가지로, @@ -2344,13 +2344,13 @@ Photo.CONTENT_ITEM_TYPE} MIME 유형으로 사진을 행에 저장합니다. 이 사진 정보를 검색하는 예시가 들어있습니다. 원시 연락처에 대한 기본 미리 보기를 검색하는 데 쓰이는 편의 클래스는 없습니다. 하지만 {@link android.provider.ContactsContract.Data} 테이블에 쿼리를 보내 원시 연락처의 -{@link android.provider.BaseColumns#_ID}, +{@code android.provider.BaseColumns#_ID}, {@link android.provider.ContactsContract.CommonDataKinds.Photo#CONTENT_ITEM_TYPE Photo.CONTENT_ITEM_TYPE}, 및 {@link android.provider.ContactsContract.Data#IS_PRIMARY} 열을 선택하면 해당 원시 연락처의 기본 사진 행을 찾을 수 있습니다. </p> <p> 한 사람의 소셜 스트림 데이터에도 사진이 포함되어 있을 수 있습니다. 이런 사진은 -{@link android.provider.ContactsContract.StreamItemPhotos} 테이블에 저장되며, 이 내용은 +{@code android.provider.ContactsContract.StreamItemPhotos} 테이블에 저장되며, 이 내용은 <a href="#StreamPhotos">소셜 스트림 사진</a>에 더 자세하게 설명되어 있습니다. </p> diff --git a/docs/html-intl/intl/pt-br/guide/components/intents-filters.jd b/docs/html-intl/intl/pt-br/guide/components/intents-filters.jd index 75bc5085229a..80e3f08d375d 100644 --- a/docs/html-intl/intl/pt-br/guide/components/intents-filters.jd +++ b/docs/html-intl/intl/pt-br/guide/components/intents-filters.jd @@ -94,7 +94,7 @@ android.content.Context#sendStickyBroadcast sendStickyBroadcast()}.</p> <ul> <li>As <b>intenções explícitas</b> especificam o componente a iniciar pelo nome (o nome de classe totalmente qualificado). Normalmente, usa-se uma intenção explícita para iniciar um componente -no próprio aplicativo porque se sabe o nome de classe da atividade ou serviço que se deseja iniciar. +no próprio aplicativo porque se sabe o nome de classe da atividade ou serviço que se deseja iniciar. Por exemplo, iniciar uma nova atividade em resposta a uma ação do usuário ou iniciar um serviço para baixar um arquivo em segundo plano.</li> @@ -220,7 +220,7 @@ como prefixo. Por exemplo:</p> <dt><b>Dados</b></dt> <dd>A URI (um objeto {@link android.net.Uri}) que referencia os dados a serem aproveitados e/ou o -tipo MIME desses dados. O tipo dos dados fornecidos geralmente é determinado pela ação da intenção. +tipo MIME desses dados. O tipo dos dados fornecidos geralmente é determinado pela ação da intenção. Por exemplo: se a ação for {@link android.content.Intent#ACTION_EDIT}, os dados devem conter a URI do documento a editar. @@ -373,9 +373,7 @@ a intenção.</p> Intent sendIntent = new Intent(); sendIntent.setAction(Intent.ACTION_SEND); sendIntent.putExtra(Intent.EXTRA_TEXT, textMessage); -sendIntent.setType({@link - org.apache.http.protocol.HTTP#PLAIN_TEXT_TYPE - HTTP.PLAIN_TEXT_TYPE}); // "text/plain" MIME type +sendIntent.setType("text/plain"); // Verify that the intent will resolve to an activity if (sendIntent.resolveActivity(getPackageManager()) != null) { @@ -453,7 +451,7 @@ título da caixa de diálogo.</p> <h2 id="Receiving">Recepção de uma intenção implícita</h2> <p>Para anunciar quais intenções implícitas o aplicativo pode receber, declare um ou mais filtros de intenções -para cada um dos componentes do aplicativo com um elemento +para cada um dos componentes do aplicativo com um elemento <a href="{@docRoot}guide/topics/manifest/intent-filter-element.html">{@code <intent-filter>}</a> no <a href="{@docRoot}guide/topics/manifest/manifest-intro.html">arquivo de manifesto</a>. Cada filtro de intenções especifica o tipo de intenções aceito com base na ação nos dados e na categoria da intenção. O sistema fornecerá uma intenção implícita ao componente do seu aplicativo somente se ela diff --git a/docs/html-intl/intl/pt-br/guide/topics/providers/contacts-provider.jd b/docs/html-intl/intl/pt-br/guide/topics/providers/contacts-provider.jd index 0bfab197e87f..0d42d2daed53 100644 --- a/docs/html-intl/intl/pt-br/guide/topics/providers/contacts-provider.jd +++ b/docs/html-intl/intl/pt-br/guide/topics/providers/contacts-provider.jd @@ -57,7 +57,7 @@ page.title=Provedor de Contatos <li>{@link android.provider.ContactsContract.Contacts}</li> <li>{@link android.provider.ContactsContract.RawContacts}</li> <li>{@link android.provider.ContactsContract.Data}</li> - <li>{@link android.provider.ContactsContract.StreamItems}</li> + <li>{@code android.provider.ContactsContract.StreamItems}</li> </ol> <h2>Exemplos relacionados</h2> <ol> @@ -170,7 +170,7 @@ de dados de uma pessoa, ele permite diversos contatos brutos para a mesma pessoa na tabela {@link android.provider.ContactsContract.RawContacts}. Em vez disso, é armazenada em uma ou mais linhas na tabela {@link android.provider.ContactsContract.Data}. Cada linha de dados tem uma coluna {@link android.provider.ContactsContract.DataColumns#RAW_CONTACT_ID Data.RAW_CONTACT_ID} que - contém o valor {@link android.provider.BaseColumns#_ID RawContacts._ID} de sua + contém o valor {@code android.provider.BaseColumns#_ID RawContacts._ID} de sua linha {@link android.provider.ContactsContract.RawContacts} pai. </p> <h3 id="RawContactsColumns">Colunas importantes de contatos brutos</h3> @@ -482,16 +482,16 @@ de dados de uma pessoa, ele permite diversos contatos brutos para a mesma pessoa </p> <p> A tabela {@link android.provider.ContactsContract.Contacts} também tem a coluna - {@link android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY}, que é + {@code android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY}, que é um vínculo "permanente" com a linha do contato. Como o Provedor de Contatos mantém contatos - automaticamente, ele pode mudar o valor de {@link android.provider.BaseColumns#_ID} da linha do contato + automaticamente, ele pode mudar o valor de {@code android.provider.BaseColumns#_ID} da linha do contato em resposta a uma agregação ou sincronização. Mesmo que isso aconteça, a URI de conteúdo {@link android.provider.ContactsContract.Contacts#CONTENT_LOOKUP_URI} combinada com - {@link android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} do contato continuará + {@code android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} do contato continuará apontado para a linha do contato para permitir o uso de - {@link android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} + {@code android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} e manter ligações com contatos "favoritos" e assim por diante. Essa coluna tem o próprio formato, que - não tem nenhuma relação com o formato da coluna {@link android.provider.BaseColumns#_ID}. + não tem nenhuma relação com o formato da coluna {@code android.provider.BaseColumns#_ID}. </p> <p> A figura 3 mostra como as três tabelas principais se relacionam entre si. @@ -601,13 +601,13 @@ de dados de uma pessoa, ele permite diversos contatos brutos para a mesma pessoa O acesso ao perfil do usuário exige permissões especiais. Além das permissões {@link android.Manifest.permission#READ_CONTACTS} e {@link android.Manifest.permission#WRITE_CONTACTS} necessárias para ler e gravar, o acesso - ao perfil do usuário requer as permissões {@link android.Manifest.permission#READ_PROFILE} e - {@link android.Manifest.permission#WRITE_PROFILE}, respectivamente, para ler e + ao perfil do usuário requer as permissões {@code android.Manifest.permission#READ_PROFILE} e + {@code android.Manifest.permission#WRITE_PROFILE}, respectivamente, para ler e gravar. </p> <p> Lembre-se de que é preciso considerar a confidencialidade de um perfil do usuário. A permissão - {@link android.Manifest.permission#READ_PROFILE} permite o acesso aos dados de identificação + {@code android.Manifest.permission#READ_PROFILE} permite o acesso aos dados de identificação pessoal do usuário do dispositivo. Certifique-se de informar ao usuário o motivo da necessidade de permissões de acesso ao perfil do usuário na descrição do aplicativo. </p> @@ -978,7 +978,7 @@ public Loader<Cursor> onCreateLoader(int id, Bundle args) { Ao inserir uma nova linha de contato bruto e as linhas de dados associados como um conjunto de objetos {@link android.content.ContentProviderOperation}, é preciso vincular as linhas de dados à linha de contato bruto pela inserção do valor - {@link android.provider.BaseColumns#_ID} do contato bruto como + {@code android.provider.BaseColumns#_ID} do contato bruto como o valor {@link android.provider.ContactsContract.DataColumns#RAW_CONTACT_ID}. Contudo, esse valor não está disponível ao criar a {@link android.content.ContentProviderOperation} para a linha de dados porque @@ -1011,7 +1011,7 @@ de {@link android.content.ContentResolver#applyBatch(String, ArrayLi em uma matriz intermediária de resultados. O valor <code>previousResult</code> é o índice de um desses resultados, que é recuperado e armazenado com o valor <code>key</code>. Isso permite a inserção de um novo registro de contato bruto e a recuperação do seu - valor {@link android.provider.BaseColumns#_ID}, seguido de uma "referência de retorno" ao + valor {@code android.provider.BaseColumns#_ID}, seguido de uma "referência de retorno" ao valor ao adicionar uma linha {@link android.provider.ContactsContract.Data}. <p> Toda a matriz de resultados é criada ao chamar @@ -1092,7 +1092,7 @@ protected void createContactEntry() { o {@link android.provider.ContactsContract.DataColumns#RAW_CONTACT_ID}. Os pontos de referência voltam ao objeto {@link android.content.ContentProviderResult} a partir da primeira operação, que adiciona a linha de contato bruto e retorna seu novo valor - {@link android.provider.BaseColumns#_ID}. Como resultado, cada linha de dados é automaticamente vinculada por meio do + {@code android.provider.BaseColumns#_ID}. Como resultado, cada linha de dados é automaticamente vinculada por meio do {@link android.provider.ContactsContract.DataColumns#RAW_CONTACT_ID} à nova linha {@link android.provider.ContactsContract.RawContacts} à qual ela pertence. </p> @@ -1231,7 +1231,7 @@ protected void createContactEntry() { {@link android.content.ContentProviderOperation#newAssertQuery(Uri)}. Para a URI de conteúdo, use {@link android.provider.ContactsContract.RawContacts#CONTENT_URI RawContacts.CONTENT_URI} - com o {@link android.provider.BaseColumns#_ID} do contato bruto anexado a ela. + com o {@code android.provider.BaseColumns#_ID} do contato bruto anexado a ela. </li> <li> Para o objeto {@link android.content.ContentProviderOperation.Builder}, chame @@ -1821,8 +1821,8 @@ elemento <code><<a href="{@docRoot}guide/topics/manifest/meta-data-element.ht </dl> <h2 id="SocialStream">Dados de fluxos sociais</h2> <p> - As tabelas {@link android.provider.ContactsContract.StreamItems} - e {@link android.provider.ContactsContract.StreamItemPhotos} + As tabelas {@code android.provider.ContactsContract.StreamItems} + e {@code android.provider.ContactsContract.StreamItemPhotos} gerenciam dados advindos de redes sociais. É possível criar um adaptador de sincronização que adicione dados de fluxo da sua própria rede a essas tabelas ou ler dados de fluxo dessas tabelas e exibi-los no seu aplicativo, ou ambos. Com esses recursos, os serviços e aplicativos @@ -1831,7 +1831,7 @@ elemento <code><<a href="{@docRoot}guide/topics/manifest/meta-data-element.ht <h3 id="StreamText">Textos de fluxos sociais</h3> <p> Itens de fluxo sempre são associados a um contato bruto. - O {@link android.provider.ContactsContract.StreamItemsColumns#RAW_CONTACT_ID} conecta-se ao + O {@code android.provider.ContactsContract.StreamItemsColumns#RAW_CONTACT_ID} conecta-se ao valor <code>_ID</code> do contato bruto. O tipo e o nome da conta do contato bruto também são armazenados na linha do item de fluxo. </p> @@ -1840,14 +1840,14 @@ elemento <code><<a href="{@docRoot}guide/topics/manifest/meta-data-element.ht </p> <dl> <dt> - {@link android.provider.ContactsContract.StreamItemsColumns#ACCOUNT_TYPE} + {@code android.provider.ContactsContract.StreamItemsColumns#ACCOUNT_TYPE} </dt> <dd> <strong>Obrigatório.</strong> O tipo de conta do usuário do contato bruto associado a esse item de fluxo. Lembre-se de definir esse valor ao inserir um item de fluxo. </dd> <dt> - {@link android.provider.ContactsContract.StreamItemsColumns#ACCOUNT_NAME} + {@code android.provider.ContactsContract.StreamItemsColumns#ACCOUNT_NAME} </dt> <dd> <strong>Obrigatório.</strong> O nome de conta do usuário do contato bruto associado @@ -1861,30 +1861,30 @@ elemento <code><<a href="{@docRoot}guide/topics/manifest/meta-data-element.ht ao inserir um item de fluxo: <ul> <li> - {@link android.provider.ContactsContract.StreamItemsColumns#CONTACT_ID}: - o valor {@link android.provider.BaseColumns#_ID} do contato ao qual esse item + {@code android.provider.ContactsContract.StreamItemsColumns#CONTACT_ID}: + o valor {@code android.provider.BaseColumns#_ID} do contato ao qual esse item de fluxo está associado. </li> <li> - {@link android.provider.ContactsContract.StreamItemsColumns#CONTACT_LOOKUP_KEY}: - o valor{@link android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} do + {@code android.provider.ContactsContract.StreamItemsColumns#CONTACT_LOOKUP_KEY}: + o valor{@code android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} do contato ao qual esse item de fluxo está associado. </li> <li> - {@link android.provider.ContactsContract.StreamItemsColumns#RAW_CONTACT_ID}: - o valor {@link android.provider.BaseColumns#_ID} do contato bruto ao qual esse item + {@code android.provider.ContactsContract.StreamItemsColumns#RAW_CONTACT_ID}: + o valor {@code android.provider.BaseColumns#_ID} do contato bruto ao qual esse item de fluxo está associado. </li> </ul> </dd> <dt> - {@link android.provider.ContactsContract.StreamItemsColumns#COMMENTS} + {@code android.provider.ContactsContract.StreamItemsColumns#COMMENTS} </dt> <dd> Opcional. Armazena informações resumidas que podem ser exibidas no início do item de fluxo. </dd> <dt> - {@link android.provider.ContactsContract.StreamItemsColumns#TEXT} + {@code android.provider.ContactsContract.StreamItemsColumns#TEXT} </dt> <dd> O texto do item de fluxo, o conteúdo que foi publicado pela fonte do item @@ -1894,7 +1894,7 @@ elemento <code><<a href="{@docRoot}guide/topics/manifest/meta-data-element.ht ou abreviar conteúdos longos, mas ele tentará evitar quebrar as tags. </dd> <dt> - {@link android.provider.ContactsContract.StreamItemsColumns#TIMESTAMP} + {@code android.provider.ContactsContract.StreamItemsColumns#TIMESTAMP} </dt> <dd> Uma string de texto contendo o tempo em que o item de fluxo foi inserido ou atualizado, em forma @@ -1905,42 +1905,42 @@ elemento <code><<a href="{@docRoot}guide/topics/manifest/meta-data-element.ht </dl> <p> Para exibir informações de identificação para os itens de fluxo, use - {@link android.provider.ContactsContract.StreamItemsColumns#RES_ICON}, - {@link android.provider.ContactsContract.StreamItemsColumns#RES_LABEL} e - {@link android.provider.ContactsContract.StreamItemsColumns#RES_PACKAGE} para vincular a recursos + {@code android.provider.ContactsContract.StreamItemsColumns#RES_ICON}, + {@code android.provider.ContactsContract.StreamItemsColumns#RES_LABEL} e + {@code android.provider.ContactsContract.StreamItemsColumns#RES_PACKAGE} para vincular a recursos no aplicativo. </p> <p> - A tabela {@link android.provider.ContactsContract.StreamItems} também contém as colunas - {@link android.provider.ContactsContract.StreamItemsColumns#SYNC1} por meio de - {@link android.provider.ContactsContract.StreamItemsColumns#SYNC4} para uso exclusivo + A tabela {@code android.provider.ContactsContract.StreamItems} também contém as colunas + {@code android.provider.ContactsContract.StreamItemsColumns#SYNC1} por meio de + {@code android.provider.ContactsContract.StreamItemsColumns#SYNC4} para uso exclusivo dos adaptadores de sincronização. </p> <h3 id="StreamPhotos">Fotos de fluxos sociais</h3> <p> - A tabela {@link android.provider.ContactsContract.StreamItemPhotos} armazena fotos associadas + A tabela {@code android.provider.ContactsContract.StreamItemPhotos} armazena fotos associadas a um item de fluxo. A coluna - {@link android.provider.ContactsContract.StreamItemPhotosColumns#STREAM_ITEM_ID} da tabela - vincula-se a valores na coluna {@link android.provider.BaseColumns#_ID} - da tabela {@link android.provider.ContactsContract.StreamItems}. Referências de fotografias são armazenadas + {@code android.provider.ContactsContract.StreamItemPhotosColumns#STREAM_ITEM_ID} da tabela + vincula-se a valores na coluna {@code android.provider.BaseColumns#_ID} + da tabela {@code android.provider.ContactsContract.StreamItems}. Referências de fotografias são armazenadas na tabela nessas colunas: </p> <dl> <dt> - Coluna {@link android.provider.ContactsContract.StreamItemPhotos#PHOTO} (um BLOB). + Coluna {@code android.provider.ContactsContract.StreamItemPhotos#PHOTO} (um BLOB). </dt> <dd> Representação binária da foto, redimensionada pelo provedor para armazenar e exibir. Essa coluna está disponível para compatibilidade retroativa com versões anteriores do Provedor de Contatos que a usavam para armazenar fotos. Contudo, na versão atual, não se deve usar essa coluna para armazenar fotos. Em vez disso, use - {@link android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_FILE_ID} ou - {@link android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_URI} (ambas são + {@code android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_FILE_ID} ou + {@code android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_URI} (ambas são descritas nos pontos a seguir) para armazenar fotos em um arquivo. Essa coluna passa a conter uma miniatura da foto, que estará disponível para leitura. </dd> <dt> - {@link android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_FILE_ID} + {@code android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_FILE_ID} </dt> <dd> Identificador numérico de uma foto de um contato bruto. Anexe esse valor à constante @@ -1950,7 +1950,7 @@ elemento <code><<a href="{@docRoot}guide/topics/manifest/meta-data-element.ht openAssetFileDescriptor()} para obter um identificador para o arquivo de foto. </dd> <dt> - {@link android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_URI} + {@code android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_URI} </dt> <dd> URI de conteúdo direcionada diretamente para o arquivo de foto da foto representada por essa linha. @@ -1965,27 +1965,27 @@ elemento <code><<a href="{@docRoot}guide/topics/manifest/meta-data-element.ht <ul> <li> Exigem permissões de acesso adicionais. Para ler o conteúdo delas, o aplicativo - deve ter a permissão {@link android.Manifest.permission#READ_SOCIAL_STREAM}. Para + deve ter a permissão {@code android.Manifest.permission#READ_SOCIAL_STREAM}. Para modificá-las, o aplicativo precisa ter a permissão - {@link android.Manifest.permission#WRITE_SOCIAL_STREAM}. + {@code android.Manifest.permission#WRITE_SOCIAL_STREAM}. </li> <li> - Para a tabela {@link android.provider.ContactsContract.StreamItems}, o número de linhas + Para a tabela {@code android.provider.ContactsContract.StreamItems}, o número de linhas armazenadas para cada contato bruto é limitado. Ao atingir o limite, o Provedor de Contatos abre espaço para novas linhas de itens de fluxo excluindo automaticamente as linhas que têm - o {@link android.provider.ContactsContract.StreamItemsColumns#TIMESTAMP} mais antigo. Para conhecer + o {@code android.provider.ContactsContract.StreamItemsColumns#TIMESTAMP} mais antigo. Para conhecer o limite, faça uma consulta à URI de conteúdo - {@link android.provider.ContactsContract.StreamItems#CONTENT_LIMIT_URI}. É possível deixar + {@code android.provider.ContactsContract.StreamItems#CONTENT_LIMIT_URI}. É possível deixar todos os argumentos, exceto a URI de conteúdo, definidos como <code>null</code>. A consulta retorna um Cursor contendo uma linha única com a coluna única - {@link android.provider.ContactsContract.StreamItems#MAX_ITEMS}. + {@code android.provider.ContactsContract.StreamItems#MAX_ITEMS}. </li> </ul> <p> - A classe {@link android.provider.ContactsContract.StreamItems.StreamItemPhotos} define - uma subtabela de {@link android.provider.ContactsContract.StreamItemPhotos} que contém as linhas + A classe {@code android.provider.ContactsContract.StreamItems.StreamItemPhotos} define + uma subtabela de {@code android.provider.ContactsContract.StreamItemPhotos} que contém as linhas de foto de um único item de fluxo. </p> <h3 id="SocialStreamInteraction">Interações de fluxos sociais</h3> @@ -1998,8 +1998,8 @@ elemento <code><<a href="{@docRoot}guide/topics/manifest/meta-data-element.ht <li> Ao sincronizar seu serviço de rede social com o Provedor de Contatos com um adaptador de sincronização, é possível recuperar atividades recentes de contatos de um usuário e armazená-las - nas tabelas {@link android.provider.ContactsContract.StreamItems} - e {@link android.provider.ContactsContract.StreamItemPhotos} para uso posterior. + nas tabelas {@code android.provider.ContactsContract.StreamItems} + e {@code android.provider.ContactsContract.StreamItemPhotos} para uso posterior. </li> <li> Além da sincronização regular, é possível ativar o adaptador de sincronização para recuperar @@ -2330,7 +2330,7 @@ elemento <code><<a href="{@docRoot}guide/topics/manifest/meta-data-element.ht {@link android.provider.ContactsContract.CommonDataKinds.Photo#CONTENT_ITEM_TYPE Photo.CONTENT_ITEM_TYPE}. A coluna {@link android.provider.ContactsContract.RawContactsColumns#CONTACT_ID} da linha é vinculada - à coluna {@link android.provider.BaseColumns#_ID} do contato bruto à qual pertence. + à coluna {@code android.provider.BaseColumns#_ID} do contato bruto à qual pertence. A classe {@link android.provider.ContactsContract.Contacts.Photo} define uma subtabela de {@link android.provider.ContactsContract.Contacts} contendo informações de foto de uma foto principal do contato, que é a foto principal do contato bruto principal do contato. Da mesma forma, @@ -2343,7 +2343,7 @@ elemento <code><<a href="{@docRoot}guide/topics/manifest/meta-data-element.ht {@link android.provider.ContactsContract.RawContacts.DisplayPhoto} contém exemplos de recuperação de informações de foto. Não há classe conveniente para recuperar a miniatura principal de um contato bruto, mas é possível enviar uma consulta - à tabela {@link android.provider.ContactsContract.Data}, selecionando no {@link android.provider.BaseColumns#_ID} + à tabela {@link android.provider.ContactsContract.Data}, selecionando no {@code android.provider.BaseColumns#_ID} do contato bruto, o {@link android.provider.ContactsContract.CommonDataKinds.Photo#CONTENT_ITEM_TYPE Photo.CONTENT_ITEM_TYPE} e a coluna @@ -2351,6 +2351,6 @@ elemento <code><<a href="{@docRoot}guide/topics/manifest/meta-data-element.ht </p> <p> Dados de fluxos sociais de uma pessoa também podem conter fotos. Elas são armazenadas - na tabela {@link android.provider.ContactsContract.StreamItemPhotos}, que é descrita com mais + na tabela {@code android.provider.ContactsContract.StreamItemPhotos}, que é descrita com mais detalhes na seção <a href="#StreamPhotos">Fotos de fluxos sociais</a>. </p> diff --git a/docs/html-intl/intl/ru/guide/components/intents-filters.jd b/docs/html-intl/intl/ru/guide/components/intents-filters.jd index 02c5e4446f35..d710081e4181 100644 --- a/docs/html-intl/intl/ru/guide/components/intents-filters.jd +++ b/docs/html-intl/intl/ru/guide/components/intents-filters.jd @@ -45,7 +45,7 @@ page.tags="IntentFilter" <p>{@link android.content.Intent} представляет собой объект обмена сообщениями, с помощью которого можно запросить выполнение действия у <a href="{@docRoot}guide/components/fundamentals.html#Components">компонента другого приложения</a>. -Несмотря на то, что объекты Intent упрощают обмен данными между компонентами по нескольким аспектам, в основном они используются +Несмотря на то, что объекты Intent упрощают обмен данными между компонентами по нескольким аспектам, в основном они используются в трех ситуациях:</p> <ul> @@ -219,7 +219,7 @@ setAction()} или конструктором {@link android.content.Intent}.</ </dd> <dt><b>Данные</b></dt> -<dd>URI (объект {@link android.net.Uri}), ссылающийся на данные, с которыми будет выполняться действие и/или +<dd>URI (объект {@link android.net.Uri}), ссылающийся на данные, с которыми будет выполняться действие и/или тип MIME этих данных. Тип передаваемых данных обычно определяется действием объекта Intent. Например, если действием является {@link android.content.Intent#ACTION_EDIT}, в данных должен содержаться URI документа, который требуется отредактировать. @@ -290,8 +290,8 @@ android.content.Intent#setDataAndType setDataAndType()}.</p> android.content.Intent#putExtras putExtras()}.</p> <p>Например, при создании объекта Intent для отправки сообщения электронной почты с методом -{@link android.content.Intent#ACTION_SEND} можно указать получателя с помощью ключа -{@link android.content.Intent#EXTRA_EMAIL}, а тему сообщения ― с помощью ключа +{@link android.content.Intent#ACTION_SEND} можно указать получателя с помощью ключа +{@link android.content.Intent#EXTRA_EMAIL}, а тему сообщения ― с помощью ключа {@link android.content.Intent#EXTRA_SUBJECT}.</p> <p>Класс {@link android.content.Intent} указывает много констант {@code EXTRA_*} @@ -335,11 +335,11 @@ startService(downloadIntent); </pre> <p>Конструктор {@link android.content.Intent#Intent(Context,Class)} -предоставляет {@link android.content.Context} приложению, а +предоставляет {@link android.content.Context} приложению, а компоненту ― объект {@link java.lang.Class}. Фактически этот объект Intent явно запускает класс{@code DownloadService} в приложении.</p> -<p>Подробные сведения о создании и запуске службы см. в руководстве +<p>Подробные сведения о создании и запуске службы см. в руководстве <a href="{@docRoot}guide/components/services.html">Службы</a>.</p> @@ -362,7 +362,7 @@ startService(downloadIntent); startActivity()}. В этом случае вызов закончится неудачей, а работа приложения аварийно завершится. Чтобы проверить, будет получен ли операцией объект Intent, вызовите метод {@link android.content.Intent#resolveActivity resolveActivity()} для своего объекта {@link android.content.Intent}. Если результатом будет значение, отличное от null, -значит, имеется хотя бы одно приложение, которое способно откликнуться на объект Intent и можно вызывать +значит, имеется хотя бы одно приложение, которое способно откликнуться на объект Intent и можно вызывать {@link android.content.Context#startActivity startActivity()}. Если же результатом будет значение null, объект Intent не следует использовать и по возможности следует отключить функцию, которая выдает этот объект Intent.</p> @@ -373,9 +373,7 @@ resolveActivity()} для своего объекта {@link android.content.Int Intent sendIntent = new Intent(); sendIntent.setAction(Intent.ACTION_SEND); sendIntent.putExtra(Intent.EXTRA_TEXT, textMessage); -sendIntent.setType({@link - org.apache.http.protocol.HTTP#PLAIN_TEXT_TYPE - HTTP.PLAIN_TEXT_TYPE}); // "text/plain" MIME type +sendIntent.setType("text/plain"); // Verify that the intent will resolve to an activity if (sendIntent.resolveActivity(getPackageManager()) != null) { @@ -410,7 +408,7 @@ Intent. Если объект Intent принимают несколько оп <p>Однако если на объект Intent могут откликнуться несколько приложений, возможно, пользователь предпочтет каждый раз использовать другое приложение, поэтому следует явно выводить диалоговое окно выбора. В диалоговом окне -выбора приложения пользователю предлагается при каждом запуске выбирать, какое приложение использовать для действия (пользователь не может выбрать приложение, +выбора приложения пользователю предлагается при каждом запуске выбирать, какое приложение использовать для действия (пользователь не может выбрать приложение, используемое по умолчанию). Например, когда ваше приложение выполняет операцию "share" (поделиться) с помощью действия {@link android.content.Intent#ACTION_SEND}, пользователи могут, в зависимости от ситуации, предпочесть каждый раз делать это с помощью разных приложений , поэтому следует всегда использовать диалоговое окно выбора, как показано на рисунке 2.</p> @@ -487,7 +485,7 @@ android.content.Intent#createChooser createChooser()} и используют у <dd>Объявляет принимаемую категорию, заданную в объекте Intent, в атрибуте {@code name}. Значение должно быть текстовой строкой действия, а не константой класса. - <p class="note"><strong>Примечание.</strong> Для получения неявных объектов Intent + <p class="note"><strong>Примечание.</strong> Для получения неявных объектов Intent <strong>необходимо включить</strong> категорию {@link android.content.Intent#CATEGORY_DEFAULT} в фильтр Intent. Методы {@link android.app.Activity#startActivity startActivity()} и @@ -644,7 +642,7 @@ android.content.Intent}. Объект {@link android.app.PendingIntent} <li>Объявление объекта Intent, который должен будет исполняться, когда пользователь выполняет действие с вашим <a href="{@docRoot}guide/topics/ui/notifiers/notifications.html">уведомлением</a> ({@link android.app.NotificationManager} системы Android исполняет {@link android.content.Intent}). - <li>Объявление объекта Intent, который должен будет исполняться, когда пользователь выполняет действие с вашим + <li>Объявление объекта Intent, который должен будет исполняться, когда пользователь выполняет действие с вашим <a href="{@docRoot}guide/topics/appwidgets/index.html">виджетом приложения</a> (приложение главного экрана исполняет {@link android.content.Intent}). <li>Объявление объекта Intent, который должен будет исполняться в указанное время в будущем ({@link android.app.AlarmManager} системы @@ -704,7 +702,7 @@ startActivity()}. Вместо этого вам необходимо будет <h3 id="ActionTest">Тестирование действия</h3> -<p>Для указания принимаемых действий объекта Intent фильтр Intent может объявлять любое (в том числе нулевое) число элементов +<p>Для указания принимаемых действий объекта Intent фильтр Intent может объявлять любое (в том числе нулевое) число элементов <a href="{@docRoot}guide/topics/manifest/action-element.html">{@code action>}</a>. Например:</p> @@ -728,7 +726,7 @@ Intent будет нечему соответствовать, поэтому в <h3 id="CategoryTest">Тестирование категории</h3> -<p>Для указания принимаемых категорий объекта Intent фильтр Intent может объявлять любое (в том числе нулевое) число элементов +<p>Для указания принимаемых категорий объекта Intent фильтр Intent может объявлять любое (в том числе нулевое) число элементов <a href="{@docRoot}guide/topics/manifest/category-element.html">{@code <category>}</a>. Например:</p> @@ -759,7 +757,7 @@ android.app.Activity#startActivityForResult startActivityForResult()}. <h3 id="DataTest">Тестирование данных</h3> -<p>Для указания принимаемых данных объекта Intent фильтр Intent может объявлять любое (в том числе нулевое) число элементов +<p>Для указания принимаемых данных объекта Intent фильтр Intent может объявлять любое (в том числе нулевое) число элементов <a href="{@docRoot}guide/topics/manifest/data-element.html">{@code <data>}</a>. Например:</p> @@ -819,14 +817,14 @@ android.app.Activity#startActivityForResult startActivityForResult()}. <li>Объект Intent, который не содержит ни URI, ни тип MIME, пройдет этот тест, только если в фильтре не указано никаких URI или типов MIME.</li> -<li>Объект Intent, в котором имеется URI, но отсутствует тип MIME (ни явный, ни тот, который можно вывести из +<li>Объект Intent, в котором имеется URI, но отсутствует тип MIME (ни явный, ни тот, который можно вывести из URI), пройдет этот тест, только если URI соответствует формату URI из фильтра , а в фильтре также не указан тип MIME.</li> <li>Объект Intent, в котором имеется тип MIME, но отсутствует URI, пройдет этот тест, только если в фильтре указан тот же тип MIME и не указан формат URI.</li> -<li>Объект Intent, в котором имеется и URI, и тип MIME (явный или тот, который можно вывести из +<li>Объект Intent, в котором имеется и URI, и тип MIME (явный или тот, который можно вывести из URI), пройдет только часть этого теста, проверяющую тип MIME, в том случае, если этот тип совпадает с типом, приведенным в фильтре. Он пройдет часть этого теста, которая проверяет URI, либо если его URI совпадает с URI из фильтра, либо если этот объект содержит URI {@code content:} diff --git a/docs/html-intl/intl/ru/guide/topics/providers/contacts-provider.jd b/docs/html-intl/intl/ru/guide/topics/providers/contacts-provider.jd index 6815295489e5..4d07856f250e 100644 --- a/docs/html-intl/intl/ru/guide/topics/providers/contacts-provider.jd +++ b/docs/html-intl/intl/ru/guide/topics/providers/contacts-provider.jd @@ -57,7 +57,7 @@ page.title=Поставщик контактов <li>{@link android.provider.ContactsContract.Contacts}</li> <li>{@link android.provider.ContactsContract.RawContacts}</li> <li>{@link android.provider.ContactsContract.Data}</li> - <li>{@link android.provider.ContactsContract.StreamItems}</li> + <li>{@code android.provider.ContactsContract.StreamItems}</li> </ol> <h2>Образцы кода по теме</h2> <ol> @@ -170,7 +170,7 @@ page.title=Поставщик контактов {@link android.provider.ContactsContract.RawContacts}. Вместо этого они хранятся в одной или нескольких строках в таблице {@link android.provider.ContactsContract.Data}. В каждой строке данных имеется столбец {@link android.provider.ContactsContract.DataColumns#RAW_CONTACT_ID Data.RAW_CONTACT_ID}, -в котором содержится значение {@link android.provider.BaseColumns#_ID RawContacts._ID} его +в котором содержится значение {@code android.provider.BaseColumns#_ID RawContacts._ID} его родительской строки{@link android.provider.ContactsContract.RawContacts}. </p> <h3 id="RawContactsColumns">Важные столбцы необработанных контактов</h3> @@ -482,16 +482,16 @@ Email.CONTENT_ITEM_TYPE}, в которой в столбце </p> <p> В таблице {@link android.provider.ContactsContract.Contacts} также имеется столбец -{@link android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY}, который выступает в роли +{@code android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY}, который выступает в роли «постоянной ссылки» на строку контакта. Поскольку поставщик контактов автоматически сохраняет контакты, -в ответ на агрегирование или синхронизацию он может изменить значение {@link android.provider.BaseColumns#_ID} +в ответ на агрегирование или синхронизацию он может изменить значение {@code android.provider.BaseColumns#_ID} строки контакта. Даже если это произойдет, URI контента {@link android.provider.ContactsContract.Contacts#CONTENT_LOOKUP_URI}, объединенный с -{@link android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} контакта, будет +{@code android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} контакта, будет по-прежнему указывать на строку контакта, поэтому вы можете смело использовать -{@link android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} +{@code android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} для сохранения ссылок на «избранные» контакты и др. Столбец имеет собственный формат, -который не связан с форматом столбца{@link android.provider.BaseColumns#_ID}. +который не связан с форматом столбца{@code android.provider.BaseColumns#_ID}. </p> <p> На рисунке 3 показаны взаимосвязи этих трех основных таблиц друг с другом. @@ -601,13 +601,13 @@ Email.CONTENT_ITEM_TYPE}, в которой в столбце Для доступа к профилю пользователя требуются особые разрешения. Кроме разрешений {@link android.Manifest.permission#READ_CONTACTS} и {@link android.Manifest.permission#WRITE_CONTACTS}, которые требуются для чтения и записи, для доступа к профилю пользователя необходимы разрешения -{@link android.Manifest.permission#READ_PROFILE} и -{@link android.Manifest.permission#WRITE_PROFILE} +{@code android.Manifest.permission#READ_PROFILE} и +{@code android.Manifest.permission#WRITE_PROFILE} на чтение и запись соответственно. </p> <p> Всегда следует помнить, что профиль пользователя представляет собой конфиденциальную информацию. Разрешение -{@link android.Manifest.permission#READ_PROFILE} предоставляет вам доступ к личной информации на устройстве +{@code android.Manifest.permission#READ_PROFILE} предоставляет вам доступ к личной информации на устройстве пользователя. В описании своего приложения обязательно укажите, для чего вам требуется доступ к профилю пользователя. </p> @@ -978,7 +978,7 @@ onLoadFinished()}. Одним их входящих аргументов для При вставке новой строки необработанного контакта и связанных с ним рядов данных в виде набора объектов {@link android.content.ContentProviderOperation} вам приходится связывать строки данных со строкой необработанного контакта путем вставки значения -{@link android.provider.BaseColumns#_ID} необработанного контакта в виде значения +{@code android.provider.BaseColumns#_ID} необработанного контакта в виде значения {@link android.provider.ContactsContract.DataColumns#RAW_CONTACT_ID}. Однако это значение недоступно, когда вы создаете{@link android.content.ContentProviderOperation} для строки данных, поскольку вы еще не применили @@ -1011,7 +1011,7 @@ onLoadFinished()}. Одним их входящих аргументов для промежуточном массиве результатов. Значением <code>previousResult</code> является индекс одного из этих результатов, который извлекается и хранится со значением <code>key</code>. Благодаря этому можно вставить новую запись необработанного контакта и получить обратно его значение -{@link android.provider.BaseColumns#_ID}, а затем создать «обратную ссылку» на +{@code android.provider.BaseColumns#_ID}, а затем создать «обратную ссылку» на значение при добавлении строки {@link android.provider.ContactsContract.Data}. <p> Целиком весь результат создается при первом вызове метода @@ -1092,7 +1092,7 @@ protected void createContactEntry() { {@link android.provider.ContactsContract.DataColumns#RAW_CONTACT_ID}. Ссылка возвращается обратно к объекту {@link android.content.ContentProviderResult} из первой операции, в результате чего добавляется строка необработанного контакта и возвращается его новое значение -{@link android.provider.BaseColumns#_ID}. После этого каждая строка данных автоматически связывается по своему +{@code android.provider.BaseColumns#_ID}. После этого каждая строка данных автоматически связывается по своему {@link android.provider.ContactsContract.DataColumns#RAW_CONTACT_ID} с новой строкой {@link android.provider.ContactsContract.RawContacts}, которой она принадлежит. </p> @@ -1231,7 +1231,7 @@ withYieldAllowed()}, который задает предел: {@link android.content.ContentProviderOperation#newAssertQuery(Uri)}. Для URI контента используйте {@link android.provider.ContactsContract.RawContacts#CONTENT_URI RawContacts.CONTENT_URI}, -добавив к нему {@link android.provider.BaseColumns#_ID} необработанного контакта. +добавив к нему {@code android.provider.BaseColumns#_ID} необработанного контакта. </li> <li> Для объекта {@link android.content.ContentProviderOperation.Builder} вызовите метод @@ -1821,9 +1821,9 @@ URI веб-службы для синхронизации с поставщик </dl> <h2 id="SocialStream">Потоки данных из социальных сетей</h2> <p> - Для управления входящими данными из социальных сетей используются таблицы {@link android.provider.ContactsContract.StreamItems} + Для управления входящими данными из социальных сетей используются таблицы {@code android.provider.ContactsContract.StreamItems} и -{@link android.provider.ContactsContract.StreamItemPhotos}. Можно создать адаптер синхронизации, который добавляет поток данных +{@code android.provider.ContactsContract.StreamItemPhotos}. Можно создать адаптер синхронизации, который добавляет поток данных из вашей собственной сети в эти таблицы, либо вы можете считывать поток данных из этих таблиц и отображать их в собственном приложении. Можно также реализовать оба этих способа. С помощью этих функций вы можете интегрировать службы социальных сетей в компоненты Android для работы с социальными сетями. @@ -1831,7 +1831,7 @@ URI веб-службы для синхронизации с поставщик <h3 id="StreamText">Текст из потока данных из социальных сетей</h3> <p> Элементы потока всегда ассоциируются с необработанным контактом. Идентификатор -{@link android.provider.ContactsContract.StreamItemsColumns#RAW_CONTACT_ID} связывается со значением +{@code android.provider.ContactsContract.StreamItemsColumns#RAW_CONTACT_ID} связывается со значением <code>_ID</code> необработанного контакта. Тип аккаунта и его имя для необработанного контакта также хранятся в строке элемента потока. </p> @@ -1840,14 +1840,14 @@ URI веб-службы для синхронизации с поставщик </p> <dl> <dt> - {@link android.provider.ContactsContract.StreamItemsColumns#ACCOUNT_TYPE} + {@code android.provider.ContactsContract.StreamItemsColumns#ACCOUNT_TYPE} </dt> <dd> <strong>Обязательный.</strong> Тип аккаунта пользователя для необработанного контакта, связанного с этим элементом потока. Не забудьте задать это значение при вставке элемента потока. </dd> <dt> - {@link android.provider.ContactsContract.StreamItemsColumns#ACCOUNT_NAME} + {@code android.provider.ContactsContract.StreamItemsColumns#ACCOUNT_NAME} </dt> <dd> <strong>Обязательный.</strong> Имя аккаунта пользователя для необработанного контакта, связанного с @@ -1861,30 +1861,30 @@ URI веб-службы для синхронизации с поставщик указанные ниже столбцы идентификатора. <ul> <li> - {@link android.provider.ContactsContract.StreamItemsColumns#CONTACT_ID}: значение -{@link android.provider.BaseColumns#_ID} для контакта, с которым ассоциирован + {@code android.provider.ContactsContract.StreamItemsColumns#CONTACT_ID}: значение +{@code android.provider.BaseColumns#_ID} для контакта, с которым ассоциирован этот элемент потока. </li> <li> - {@link android.provider.ContactsContract.StreamItemsColumns#CONTACT_LOOKUP_KEY}: значение -{@link android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} для контакта, с которым ассоциирован + {@code android.provider.ContactsContract.StreamItemsColumns#CONTACT_LOOKUP_KEY}: значение +{@code android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} для контакта, с которым ассоциирован этот элемент потока. </li> <li> - {@link android.provider.ContactsContract.StreamItemsColumns#RAW_CONTACT_ID}: значение -{@link android.provider.BaseColumns#_ID} для необработанного контакта, с которым ассоциирован + {@code android.provider.ContactsContract.StreamItemsColumns#RAW_CONTACT_ID}: значение +{@code android.provider.BaseColumns#_ID} для необработанного контакта, с которым ассоциирован этот элемент потока. </li> </ul> </dd> <dt> - {@link android.provider.ContactsContract.StreamItemsColumns#COMMENTS} + {@code android.provider.ContactsContract.StreamItemsColumns#COMMENTS} </dt> <dd> Необязательный. В нем хранится сводная информация, которую можно отобразить в начале элемента потока. </dd> <dt> - {@link android.provider.ContactsContract.StreamItemsColumns#TEXT} + {@code android.provider.ContactsContract.StreamItemsColumns#TEXT} </dt> <dd> Текст элемента потока: либо контент, опубликованный источником элемента, @@ -1894,7 +1894,7 @@ URI веб-службы для синхронизации с поставщик или заменить его часть многоточием, однако он попытается избежать нарушения тегов. </dd> <dt> - {@link android.provider.ContactsContract.StreamItemsColumns#TIMESTAMP} + {@code android.provider.ContactsContract.StreamItemsColumns#TIMESTAMP} </dt> <dd> Текстовая строка с информацией о времени вставки или обновления элемента в @@ -1905,42 +1905,42 @@ URI веб-службы для синхронизации с поставщик </dl> <p> Для отображения идентификационной информации для элементов потока воспользуйтесь -{@link android.provider.ContactsContract.StreamItemsColumns#RES_ICON}, -{@link android.provider.ContactsContract.StreamItemsColumns#RES_LABEL} и -{@link android.provider.ContactsContract.StreamItemsColumns#RES_PACKAGE} для связывания с ресурсами +{@code android.provider.ContactsContract.StreamItemsColumns#RES_ICON}, +{@code android.provider.ContactsContract.StreamItemsColumns#RES_LABEL} и +{@code android.provider.ContactsContract.StreamItemsColumns#RES_PACKAGE} для связывания с ресурсами в вашем приложении. </p> <p> - В таблице {@link android.provider.ContactsContract.StreamItems} также имеются столбцы -{@link android.provider.ContactsContract.StreamItemsColumns#SYNC1}—{@link android.provider.ContactsContract.StreamItemsColumns#SYNC4}, + В таблице {@code android.provider.ContactsContract.StreamItems} также имеются столбцы +{@code android.provider.ContactsContract.StreamItemsColumns#SYNC1}—{@code android.provider.ContactsContract.StreamItemsColumns#SYNC4}, которые предназначены исключительно для адаптеров синхронизации. </p> <h3 id="StreamPhotos">Фотографии из потока данных из социальных сетей</h3> <p> Фотографии, связанные с элементом потока, хранятся в таблице -{@link android.provider.ContactsContract.StreamItemPhotos}. Столбец -{@link android.provider.ContactsContract.StreamItemPhotosColumns#STREAM_ITEM_ID} -в этой таблице связан со столбцом {@link android.provider.BaseColumns#_ID} -в таблице {@link android.provider.ContactsContract.StreamItems}. Ссылки на фотографии хранятся в следующих столбцах +{@code android.provider.ContactsContract.StreamItemPhotos}. Столбец +{@code android.provider.ContactsContract.StreamItemPhotosColumns#STREAM_ITEM_ID} +в этой таблице связан со столбцом {@code android.provider.BaseColumns#_ID} +в таблице {@code android.provider.ContactsContract.StreamItems}. Ссылки на фотографии хранятся в следующих столбцах таблицы: </p> <dl> <dt> - Столбец {@link android.provider.ContactsContract.StreamItemPhotos#PHOTO} (объект BLOB). + Столбец {@code android.provider.ContactsContract.StreamItemPhotos#PHOTO} (объект BLOB). </dt> <dd> Представление фотографии в двоичном формате и с измененным поставщиком размером для ее хранения и отображения. Этот столбец доступен для обеспечения обратной совместимости с предыдущими версиями поставщика контактов, которые использовались для хранения фотографий. Однако в текущей версии поставщика мы не рекомендуем использовать этот столбец для хранения фотографий. Вместо этого воспользуйтесь столбцом -{@link android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_FILE_ID} или -{@link android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_URI} (или обоими +{@code android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_FILE_ID} или +{@code android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_URI} (или обоими столбцами, как описано далее) для хранения фотографий в файле. В этом столбце теперь хранятся миниатюры фотографий, доступных для чтения. </dd> <dt> - {@link android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_FILE_ID} + {@code android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_FILE_ID} </dt> <dd> Числовой идентификатор фотографии для необработанного контакта. Добавьте это значение к константе @@ -1950,7 +1950,7 @@ URI веб-службы для синхронизации с поставщик openAssetFileDescriptor()}, чтобы получить средство обработки файла фотографии. </dd> <dt> - {@link android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_URI} + {@code android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_URI} </dt> <dd> URI контента, указывающий на файл фотографии, для фотографии, которая представлена этой строкой. @@ -1965,27 +1965,27 @@ openAssetFileDescriptor()}, передав в него этот URI, чтобы <ul> <li> Для работы с этими таблицами требуются дополнительные разрешения на доступ. Для чтения данных из них вашему приложению -должно быть предоставлено разрешение {@link android.Manifest.permission#READ_SOCIAL_STREAM}. Для +должно быть предоставлено разрешение {@code android.Manifest.permission#READ_SOCIAL_STREAM}. Для изменения таблиц ваше приложение должно иметь разрешение -{@link android.Manifest.permission#WRITE_SOCIAL_STREAM}. +{@code android.Manifest.permission#WRITE_SOCIAL_STREAM}. </li> <li> - Для таблицы {@link android.provider.ContactsContract.StreamItems} существует ограничение на количество строк, + Для таблицы {@code android.provider.ContactsContract.StreamItems} существует ограничение на количество строк, которое можно хранить для каждого необработанного контакта. При достижении этого ограничения поставщик контактов освобождает место для новых строк элементов потока путем автоматического удаления строк со самой старой меткой -{@link android.provider.ContactsContract.StreamItemsColumns#TIMESTAMP}. Чтобы получить это ограничение, +{@code android.provider.ContactsContract.StreamItemsColumns#TIMESTAMP}. Чтобы получить это ограничение, запросите URI контента -{@link android.provider.ContactsContract.StreamItems#CONTENT_LIMIT_URI}. Для всех аргументов, +{@code android.provider.ContactsContract.StreamItems#CONTENT_LIMIT_URI}. Для всех аргументов, отличных от URI контента, можно оставить значение <code>null</code>. Запрос возвращает объект Cursor, в котором содержится одна строка с одним столбцом -{@link android.provider.ContactsContract.StreamItems#MAX_ITEMS}. +{@code android.provider.ContactsContract.StreamItems#MAX_ITEMS}. </li> </ul> <p> - Класс {@link android.provider.ContactsContract.StreamItems.StreamItemPhotos} определяет -дочернюю таблицу объектов {@link android.provider.ContactsContract.StreamItemPhotos}, в которой содержатся + Класс {@code android.provider.ContactsContract.StreamItems.StreamItemPhotos} определяет +дочернюю таблицу объектов {@code android.provider.ContactsContract.StreamItemPhotos}, в которой содержатся строки для одного элемента потока. </p> <h3 id="SocialStreamInteraction">Взаимодействие с потоками данных из социальных сетей</h3> @@ -1998,8 +1998,8 @@ openAssetFileDescriptor()}, передав в него этот URI, чтобы <li> Организовав синхронизацию данных из социальной службы с поставщиком контактов посредством адаптера синхронизации, вы можете получать данные о недавней активности контактов пользователя и хранить такие данные в таблицах -,{@link android.provider.ContactsContract.StreamItems} -и {@link android.provider.ContactsContract.StreamItemPhotos} для использования в дальнейшем. +,{@code android.provider.ContactsContract.StreamItems} +и {@code android.provider.ContactsContract.StreamItemPhotos} для использования в дальнейшем. </li> <li> Помимо регулярной синхронизации, адаптер синхронизации можно настроить на получение @@ -2330,7 +2330,7 @@ Settings.UNGROUPED_VISIBLE} значение «1». После этого пос {@link android.provider.ContactsContract.CommonDataKinds.Photo#CONTENT_ITEM_TYPE Photo.CONTENT_ITEM_TYPE} типа MIME. Столбец {@link android.provider.ContactsContract.RawContactsColumns#CONTACT_ID} в строке связан со столбцом -{@link android.provider.BaseColumns#_ID} необработанного контакта, которому он принадлежит. +{@code android.provider.BaseColumns#_ID} необработанного контакта, которому он принадлежит. Класс {@link android.provider.ContactsContract.Contacts.Photo} определяет вложенную таблицу {@link android.provider.ContactsContract.Contacts}, в которой содержится информация об основной фотографии контакта (которая является основной фотографией основного необработанного контакта этого контакта). Аналогичным образом класс @@ -2344,13 +2344,13 @@ Photo.CONTENT_ITEM_TYPE} типа MIME. Столбец получения информации о фотографии. К сожалению, отсутствует класс для удобного извлечения миниатюры основной фотографии необработанного контакта, однако вы можете отправить запрос в таблицу {@link android.provider.ContactsContract.Data}, выбрать -{@link android.provider.BaseColumns#_ID} необработанного контакта, +{@code android.provider.BaseColumns#_ID} необработанного контакта, {@link android.provider.ContactsContract.CommonDataKinds.Photo#CONTENT_ITEM_TYPE Photo.CONTENT_ITEM_TYPE} и столбец {@link android.provider.ContactsContract.Data#IS_PRIMARY}, чтобы найти строку основной фотографии необработанного контакта. </p> <p> Потоки данных из социальных сетей также могут включать фотографии. Они находятся в таблице -{@link android.provider.ContactsContract.StreamItemPhotos}, дополнительные сведения о которой представлены в разделе +{@code android.provider.ContactsContract.StreamItemPhotos}, дополнительные сведения о которой представлены в разделе <a href="#StreamPhotos">Фотографии из потока данных из социальных сетей</a>. </p> diff --git a/docs/html-intl/intl/vi/guide/components/intents-filters.jd b/docs/html-intl/intl/vi/guide/components/intents-filters.jd index 5bd0ddb2ee2e..cdc623f8e8ce 100644 --- a/docs/html-intl/intl/vi/guide/components/intents-filters.jd +++ b/docs/html-intl/intl/vi/guide/components/intents-filters.jd @@ -373,9 +373,7 @@ bạn không nên sử dụng ý định và, nếu có thể, bạn nên vô hi Intent sendIntent = new Intent(); sendIntent.setAction(Intent.ACTION_SEND); sendIntent.putExtra(Intent.EXTRA_TEXT, textMessage); -sendIntent.setType({@link - org.apache.http.protocol.HTTP#PLAIN_TEXT_TYPE - HTTP.PLAIN_TEXT_TYPE}); // "text/plain" MIME type +sendIntent.setType("text/plain"); // Verify that the intent will resolve to an activity if (sendIntent.resolveActivity(getPackageManager()) != null) { @@ -550,7 +548,7 @@ khai báo các bộ lọc ý định cho dịch vụ của bạn.</p> <p class="note"><strong>Lưu ý:</strong> Đối với tất cả hoạt động, bạn phải khai báo các bộ lọc ý định của mình trong một tệp bản kê khai. -Tuy nhiên, các bộ lọc cho hàm nhận quảng bá có thể được đăng ký linh hoạt bằng cách gọi +Tuy nhiên, các bộ lọc cho hàm nhận quảng bá có thể được đăng ký linh hoạt bằng cách gọi {@link android.content.Context#registerReceiver(BroadcastReceiver, IntentFilter, String, Handler) registerReceiver()}. Sau đó, bạn có thể bỏ đăng ký hàm nhận đó bằng {@link android.content.Context#unregisterReceiver unregisterReceiver()}. Làm vậy sẽ cho phép ứng dụng của bạn @@ -672,7 +670,7 @@ startActivity()}. Thay vào đó, bạn phải khai báo loại thành phần th các phương pháp để tạo lập {@link android.app.PendingIntent} trên là những phương pháp {@link android.app.PendingIntent} duy nhất mà bạn sẽ cần.</p> -<p>Mỗi phương pháp sẽ lấy ứng dụng {@link android.content.Context} hiện tại, +<p>Mỗi phương pháp sẽ lấy ứng dụng {@link android.content.Context} hiện tại, {@link android.content.Intent} mà bạn muốn bao bọc, và một hoặc nhiều cờ quy định cách thức sử dụng ý định (chẳng hạn như ý định có thể được sử dụng nhiều hơn một lần hay không).</p> @@ -704,7 +702,7 @@ về phương diện bộ lọc ý định được khai báo như thế nào tr <h3 id="ActionTest">Kiểm tra hành động</h3> -<p>Để quy định các hành động của ý định được chấp nhận, một bộ lọc ý định có thể khai báo 0 phần tử +<p>Để quy định các hành động của ý định được chấp nhận, một bộ lọc ý định có thể khai báo 0 phần tử <a href="{@docRoot}guide/topics/manifest/action-element.html">{@code <action>}</a> hoặc nhiều hơn. Ví dụ:</p> @@ -728,7 +726,7 @@ chứa ít nhất một hành động).</p> <h3 id="CategoryTest">Kiểm tra thể loại</h3> -<p>Để quy định các thể loại của ý định được chấp nhận, một bộ lọc ý định có thể khai báo 0 phần tử +<p>Để quy định các thể loại của ý định được chấp nhận, một bộ lọc ý định có thể khai báo 0 phần tử <a href="{@docRoot}guide/topics/manifest/category-element.html">{@code <category>}</a> hoặc nhiều hơn. Ví dụ:</p> @@ -747,7 +745,7 @@ khai báo nhiều thể loại hơn được quy định trong {@link android.co luôn vượt qua kiểm tra này, không phụ thuộc vào những thể loại nào được khai báo trong bộ lọc.</p> <p class="note"><strong>Lưu ý:</strong> -Android sẽ tự động áp dụng thể loại {@link android.content.Intent#CATEGORY_DEFAULT} +Android sẽ tự động áp dụng thể loại {@link android.content.Intent#CATEGORY_DEFAULT} cho tất cả ý định không biểu thị được chuyển tới {@link android.content.Context#startActivity startActivity()} và {@link android.app.Activity#startActivityForResult startActivityForResult()}. @@ -759,7 +757,7 @@ nêu một thể loại cho {@code "android.intent.category.DEFAULT"} trong các <h3 id="DataTest">Kiểm tra dữ liệu</h3> -<p>Để quy định dữ liệu của ý định được chấp nhận, một bộ lọc ý định có thể khai báo 0 phần tử +<p>Để quy định dữ liệu của ý định được chấp nhận, một bộ lọc ý định có thể khai báo 0 phần tử <a href="{@docRoot}guide/topics/manifest/data-element.html">{@code <data>}</a> hoặc nhiều hơn. Ví dụ:</p> @@ -875,7 +873,7 @@ thành phần có thể truy xuất dữ liệu video từ mạng để thực h <p>Các ý định được so khớp với các bộ lọc ý định không chỉ để khám phá một thành phần mục tiêu cần kích hoạt, mà còn để khám phá điều gì đó về tập hợp -các thành phần trên thiết bị. Ví dụ, ứng dụng Trang chủ đưa trình khởi chạy ứng dụng +các thành phần trên thiết bị. Ví dụ, ứng dụng Trang chủ đưa trình khởi chạy ứng dụng vào bằng cách tìm tất cả hoạt động có bộ lọc ý định mà quy định hành động {@link android.content.Intent#ACTION_MAIN} và thể loại {@link android.content.Intent#CATEGORY_LAUNCHER}.</p> diff --git a/docs/html-intl/intl/vi/guide/topics/providers/contacts-provider.jd b/docs/html-intl/intl/vi/guide/topics/providers/contacts-provider.jd index e4f839f261fc..2fa2ed3c9bdf 100644 --- a/docs/html-intl/intl/vi/guide/topics/providers/contacts-provider.jd +++ b/docs/html-intl/intl/vi/guide/topics/providers/contacts-provider.jd @@ -57,7 +57,7 @@ page.title=Trình cung cấp Danh bạ <li>{@link android.provider.ContactsContract.Contacts}</li> <li>{@link android.provider.ContactsContract.RawContacts}</li> <li>{@link android.provider.ContactsContract.Data}</li> - <li>{@link android.provider.ContactsContract.StreamItems}</li> + <li>{@code android.provider.ContactsContract.StreamItems}</li> </ol> <h2>Các Mẫu Liên quan</h2> <ol> @@ -170,7 +170,7 @@ page.title=Trình cung cấp Danh bạ {@link android.provider.ContactsContract.RawContacts}. Thay vào đó, nó được lưu giữ trong một hoặc nhiều hàng trong bảng {@link android.provider.ContactsContract.Data}. Mỗi hàng dữ liệu có một cột {@link android.provider.ContactsContract.DataColumns#RAW_CONTACT_ID Data.RAW_CONTACT_ID} chứa - giá trị {@link android.provider.BaseColumns#_ID RawContacts._ID} của + giá trị {@code android.provider.BaseColumns#_ID RawContacts._ID} của hàng {@link android.provider.ContactsContract.RawContacts} mẹ của nó. </p> <h3 id="RawContactsColumns">Các cột liên lạc thô quan trọng</h3> @@ -482,16 +482,16 @@ page.title=Trình cung cấp Danh bạ </p> <p> Bảng {@link android.provider.ContactsContract.Contacts} cũng có cột - {@link android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} mà là một liên kết + {@code android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} mà là một liên kết "cố định" với hàng liên lạc đó. Vì Trình cung cấp Danh bạ tự động duy trì - các liên lạc, nó có thể thay đổi giá trị {@link android.provider.BaseColumns#_ID} của một hàng liên lạc + các liên lạc, nó có thể thay đổi giá trị {@code android.provider.BaseColumns#_ID} của một hàng liên lạc hồi đáp lại một sự tổng hợp hoặc đồng bộ. Ngay cả khi điều này xảy ra, URI nội dung {@link android.provider.ContactsContract.Contacts#CONTENT_LOOKUP_URI} kết hợp với - {@link android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} của liên lạc sẽ vẫn + {@code android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} của liên lạc sẽ vẫn chỉ về hàng liên lạc đó, vì thế bạn có thể sử dụng - {@link android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} + {@code android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} để duy trì các liên kết đến liên lạc "yêu thích", v.v. Cột này có định dạng riêng không - liên quan tới định dạng của cột {@link android.provider.BaseColumns#_ID}. + liên quan tới định dạng của cột {@code android.provider.BaseColumns#_ID}. </p> <p> Hình 3 minh họa mối liên quan giữa ba bảng chính này với nhau. @@ -601,13 +601,13 @@ page.title=Trình cung cấp Danh bạ Truy cập hồ sơ người dùng đòi hỏi phải có các quyền đặc biệt. Ngoài các quyền {@link android.Manifest.permission#READ_CONTACTS} và {@link android.Manifest.permission#WRITE_CONTACTS} cần để đọc và ghi, truy cập - hồ sơ người dùng còn yêu cầu quyền {@link android.Manifest.permission#READ_PROFILE} và - {@link android.Manifest.permission#WRITE_PROFILE} tương ứng cho quyền truy cập đọc và + hồ sơ người dùng còn yêu cầu quyền {@code android.Manifest.permission#READ_PROFILE} và + {@code android.Manifest.permission#WRITE_PROFILE} tương ứng cho quyền truy cập đọc và ghi. </p> <p> Nhớ rằng bạn nên coi hồ sơ của một người dùng là nội dung nhạy cảm. Quyền - {@link android.Manifest.permission#READ_PROFILE} cho phép bạn truy cập dữ liệu xác định cá nhân + {@code android.Manifest.permission#READ_PROFILE} cho phép bạn truy cập dữ liệu xác định cá nhân của người dùng thiết bị. Chắc chắn phải nói cho người dùng biết lý do tại sao bạn cần các quyền truy cập hồ sơ người dùng trong phần mô tả ứng dụng của mình. </p> @@ -978,7 +978,7 @@ public Loader<Cursor> onCreateLoader(int id, Bundle args) { Khi bạn đang chèn một hàng liên lạc thô mới và các hàng dữ liệu liên kết của nó như một tập hợp các đối tượng {@link android.content.ContentProviderOperation}, bạn phải liên kết các hàng dữ liệu với hàng liên lạc thô bằng cách chèn giá trị - {@link android.provider.BaseColumns#_ID} của liên lạc thô làm giá trị + {@code android.provider.BaseColumns#_ID} của liên lạc thô làm giá trị {@link android.provider.ContactsContract.DataColumns#RAW_CONTACT_ID}. Tuy nhiên, giá trị này không có sẵn khi bạn đang tạo {@link android.content.ContentProviderOperation} cho hàng dữ liệu, vì bạn chưa áp dụng @@ -1011,7 +1011,7 @@ public Loader<Cursor> onCreateLoader(int id, Bundle args) { trung gian. Giá trị <code>previousResult</code> là chỉ mục của một trong những kết quả này, nó được truy xuất và lưu giữ với giá trị <code>key</code> . Điều này cho phép bạn chèn một bản ghi liên lạc thô mới và nhận lại giá trị - {@link android.provider.BaseColumns#_ID} của nó, rồi thực hiện một "tham chiếu ngược" về + {@code android.provider.BaseColumns#_ID} của nó, rồi thực hiện một "tham chiếu ngược" về giá trị đó khi bạn thêm một hàng {@link android.provider.ContactsContract.Data}. <p> Toàn bộ mảng kết quả được tạo khi bạn lần đầu gọi @@ -1091,7 +1091,7 @@ protected void createContactEntry() { để nhận {@link android.provider.ContactsContract.DataColumns#RAW_CONTACT_ID}. Tham chiếu đó sẽ trỏ ngược về đối tượng {@link android.content.ContentProviderResult} từ thao tác đầu tiên, - là thao tác thêm hàng liên lạc thô và trả về giá trị {@link android.provider.BaseColumns#_ID} + là thao tác thêm hàng liên lạc thô và trả về giá trị {@code android.provider.BaseColumns#_ID} mới của nó. Kết quả là, mỗi hàng dữ liệu được tự động liên kết bởi {@link android.provider.ContactsContract.DataColumns#RAW_CONTACT_ID} của nó với hàng {@link android.provider.ContactsContract.RawContacts} mới mà nó thuộc về. @@ -1231,7 +1231,7 @@ protected void createContactEntry() { {@link android.content.ContentProviderOperation#newAssertQuery(Uri)}. Đối với URI nội dung, sử dụng {@link android.provider.ContactsContract.RawContacts#CONTENT_URI RawContacts.CONTENT_URI} - với {@link android.provider.BaseColumns#_ID} của liên lạc thô được nối với nó. + với {@code android.provider.BaseColumns#_ID} của liên lạc thô được nối với nó. </li> <li> Đối với đối tượng {@link android.content.ContentProviderOperation.Builder}, hãy gọi @@ -1821,8 +1821,8 @@ mà cung cấp dữ liệu cụ thể cho </dl> <h2 id="SocialStream">Dữ liệu từ Luồng Xã hội</h2> <p> - Các bảng {@link android.provider.ContactsContract.StreamItems} và - {@link android.provider.ContactsContract.StreamItemPhotos} quản lý + Các bảng {@code android.provider.ContactsContract.StreamItems} và + {@code android.provider.ContactsContract.StreamItemPhotos} quản lý dữ liệu đến từ các mạng xã hội. Bạn có thể ghi một trình điều hợp đồng bộ mà thêm dữ liệu luồng từ mạng của chính mình vào những bảng này, hoặc bạn có thể đọc dữ liệu luồng từ những bảng này và hiển thị nó trong ứng dụng của chính mình, hoặc cả hai. Với những tính năng này, các dịch vụ và ứng dụng @@ -1831,7 +1831,7 @@ mà cung cấp dữ liệu cụ thể cho <h3 id="StreamText">Văn bản từ luồng xã hội</h3> <p> Các mục dòng dữ liệu luôn được liên kết với một liên lạc thô. - {@link android.provider.ContactsContract.StreamItemsColumns#RAW_CONTACT_ID} liên kết với giá trị + {@code android.provider.ContactsContract.StreamItemsColumns#RAW_CONTACT_ID} liên kết với giá trị <code>_ID</code> của liên lạc thô mới. Loại tài khoản và tên tài khoản của liên lạc thô cũng được lưu giữ trong hàng mục dòng. </p> @@ -1840,14 +1840,14 @@ mà cung cấp dữ liệu cụ thể cho </p> <dl> <dt> - {@link android.provider.ContactsContract.StreamItemsColumns#ACCOUNT_TYPE} + {@code android.provider.ContactsContract.StreamItemsColumns#ACCOUNT_TYPE} </dt> <dd> <strong>Bắt buộc.</strong> Loại tài khoản của người dùng đối với liên lạc thô được liên kết với mục dòng này. Nhớ đặt giá trị này khi bạn chèn một mục dòng. </dd> <dt> - {@link android.provider.ContactsContract.StreamItemsColumns#ACCOUNT_NAME} + {@code android.provider.ContactsContract.StreamItemsColumns#ACCOUNT_NAME} </dt> <dd> <strong>Bắt buộc.</strong> Tên tài khoản của người dùng đối với liên lạc thô được liên kết với mục dòng @@ -1861,30 +1861,30 @@ mà cung cấp dữ liệu cụ thể cho một mục dòng: <ul> <li> - {@link android.provider.ContactsContract.StreamItemsColumns#CONTACT_ID}: Giá trị - {@link android.provider.BaseColumns#_ID} của liên lạc mà mục dòng + {@code android.provider.ContactsContract.StreamItemsColumns#CONTACT_ID}: Giá trị + {@code android.provider.BaseColumns#_ID} của liên lạc mà mục dòng này được liên kết với. </li> <li> - {@link android.provider.ContactsContract.StreamItemsColumns#CONTACT_LOOKUP_KEY}: Giá trị - {@link android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} của liên lạc + {@code android.provider.ContactsContract.StreamItemsColumns#CONTACT_LOOKUP_KEY}: Giá trị + {@code android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} của liên lạc mà mục dòng này được liên kết với. </li> <li> - {@link android.provider.ContactsContract.StreamItemsColumns#RAW_CONTACT_ID}: Giá trị - {@link android.provider.BaseColumns#_ID} của liên lạc thô mà mục dòng này + {@code android.provider.ContactsContract.StreamItemsColumns#RAW_CONTACT_ID}: Giá trị + {@code android.provider.BaseColumns#_ID} của liên lạc thô mà mục dòng này được liên kết với. </li> </ul> </dd> <dt> - {@link android.provider.ContactsContract.StreamItemsColumns#COMMENTS} + {@code android.provider.ContactsContract.StreamItemsColumns#COMMENTS} </dt> <dd> Tùy chọn. Lưu giữ thông tin tóm tắt mà bạn có thể hiển thị ở phần đầu của một mục dòng. </dd> <dt> - {@link android.provider.ContactsContract.StreamItemsColumns#TEXT} + {@code android.provider.ContactsContract.StreamItemsColumns#TEXT} </dt> <dd> Văn bản của mục dòng, hoặc là nội dung đã được đăng bởi nguồn của mục đó, @@ -1894,7 +1894,7 @@ mà cung cấp dữ liệu cụ thể cho cắt ngắn bằng dấu ba chấm các nội dung dài, nhưng sẽ cố gắng tránh làm hỏng các tag. </dd> <dt> - {@link android.provider.ContactsContract.StreamItemsColumns#TIMESTAMP} + {@code android.provider.ContactsContract.StreamItemsColumns#TIMESTAMP} </dt> <dd> Xâu văn bản chứa thời gian mà mục dòng được chèn hoặc cập nhật, có @@ -1905,42 +1905,42 @@ mà cung cấp dữ liệu cụ thể cho </dl> <p> Để hiển thị thông tin nhận dạng cho các mục dòng của bạn, hãy sử dụng - {@link android.provider.ContactsContract.StreamItemsColumns#RES_ICON}, - {@link android.provider.ContactsContract.StreamItemsColumns#RES_LABEL}, và - {@link android.provider.ContactsContract.StreamItemsColumns#RES_PACKAGE} để liên kết với các tài nguyên + {@code android.provider.ContactsContract.StreamItemsColumns#RES_ICON}, + {@code android.provider.ContactsContract.StreamItemsColumns#RES_LABEL}, và + {@code android.provider.ContactsContract.StreamItemsColumns#RES_PACKAGE} để liên kết với các tài nguyên trong ứng dụng của mình. </p> <p> - Bảng {@link android.provider.ContactsContract.StreamItems} chứa các cột - {@link android.provider.ContactsContract.StreamItemsColumns#SYNC1} thông qua - {@link android.provider.ContactsContract.StreamItemsColumns#SYNC4} dành riêng để sử dụng + Bảng {@code android.provider.ContactsContract.StreamItems} chứa các cột + {@code android.provider.ContactsContract.StreamItemsColumns#SYNC1} thông qua + {@code android.provider.ContactsContract.StreamItemsColumns#SYNC4} dành riêng để sử dụng trình điều hợp đồng bộ. </p> <h3 id="StreamPhotos">Ảnh từ luồng xã hội</h3> <p> - Bảng {@link android.provider.ContactsContract.StreamItemPhotos} lưu giữ ảnh được liên kết + Bảng {@code android.provider.ContactsContract.StreamItemPhotos} lưu giữ ảnh được liên kết với một mục dòng. Cột - {@link android.provider.ContactsContract.StreamItemPhotosColumns#STREAM_ITEM_ID} của bảng - liên kết với các giá trị trong {@link android.provider.BaseColumns#_ID} của bảng - {@link android.provider.ContactsContract.StreamItems}. Các tham chiếu ảnh được lưu giữ trong + {@code android.provider.ContactsContract.StreamItemPhotosColumns#STREAM_ITEM_ID} của bảng + liên kết với các giá trị trong {@code android.provider.BaseColumns#_ID} của bảng + {@code android.provider.ContactsContract.StreamItems}. Các tham chiếu ảnh được lưu giữ trong bảng ở những cột này: </p> <dl> <dt> - Cột {@link android.provider.ContactsContract.StreamItemPhotos#PHOTO} (một BLOB). + Cột {@code android.provider.ContactsContract.StreamItemPhotos#PHOTO} (một BLOB). </dt> <dd> Biểu diễn dạng nhị phân của ảnh, được trình cung cấp đổi kích cỡ để lưu giữ và hiển thị. Cột này có sẵn để tương thích ngược với các phiên bản trước của Trình cung cấp Danh bạ mà đã sử dụng nó để lưu giữ ảnh. Tuy nhiên, trong phiên bản hiện tại bạn không nên sử dụng cột này để lưu giữ ảnh. Thay vào đó, hãy sử dụng - hoặc {@link android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_FILE_ID} hoặc - {@link android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_URI} (cả hai + hoặc {@code android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_FILE_ID} hoặc + {@code android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_URI} (cả hai đều được mô tả trong các điểm sau) để lưu giữ ảnh trong một tệp. Lúc này, cột này chứa một hình thu nhỏ của ảnh sẵn sàng để đọc. </dd> <dt> - {@link android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_FILE_ID} + {@code android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_FILE_ID} </dt> <dd> Một mã định danh dạng số của ảnh cho một liên lạc thô. Nối giá trị này với hằng số @@ -1950,7 +1950,7 @@ mà cung cấp dữ liệu cụ thể cho openAssetFileDescriptor()} để nhận một điều khiển (handle) cho tệp ảnh. </dd> <dt> - {@link android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_URI} + {@code android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_URI} </dt> <dd> Một URI nội dung trỏ trực tiếp tới tệp ảnh cho ảnh được đại diện bởi hàng này. @@ -1965,27 +1965,27 @@ mà cung cấp dữ liệu cụ thể cho <ul> <li> Những bảng này yêu cầu quyền truy cập bổ sung. Để đọc từ chúng, ứng dụng của bạn - phải có quyền {@link android.Manifest.permission#READ_SOCIAL_STREAM}. Để + phải có quyền {@code android.Manifest.permission#READ_SOCIAL_STREAM}. Để sửa đổi chúng, ứng dụng của bạn phải có quyền - {@link android.Manifest.permission#WRITE_SOCIAL_STREAM}. + {@code android.Manifest.permission#WRITE_SOCIAL_STREAM}. </li> <li> - Đối với bảng {@link android.provider.ContactsContract.StreamItems}, số hàng + Đối với bảng {@code android.provider.ContactsContract.StreamItems}, số hàng được lưu giữ cho mỗi liên lạc thô sẽ bị giới hạn. Sau khi đạt đến giới hạn này, Trình cung cấp Danh bạ sẽ tạo khoảng trống cho các hàng mục dòng mới bằng cách tự động xóa những hàng có - {@link android.provider.ContactsContract.StreamItemsColumns#TIMESTAMP} lâu nhất. Để nhận + {@code android.provider.ContactsContract.StreamItemsColumns#TIMESTAMP} lâu nhất. Để nhận giới hạn, hãy phát hành một truy vấn tới URI nội dung - {@link android.provider.ContactsContract.StreamItems#CONTENT_LIMIT_URI}. Bạn có thể để + {@code android.provider.ContactsContract.StreamItems#CONTENT_LIMIT_URI}. Bạn có thể để tất cả các tham đối khác ngoài URI nội dung được đặt về <code>null</code>. Truy vấn trả về một Con chạy chứa một hàng đơn, với cột đơn - {@link android.provider.ContactsContract.StreamItems#MAX_ITEMS}. + {@code android.provider.ContactsContract.StreamItems#MAX_ITEMS}. </li> </ul> <p> - Lớp {@link android.provider.ContactsContract.StreamItems.StreamItemPhotos} định nghĩa một - bảng con {@link android.provider.ContactsContract.StreamItemPhotos} chứa các hàng ảnh + Lớp {@code android.provider.ContactsContract.StreamItems.StreamItemPhotos} định nghĩa một + bảng con {@code android.provider.ContactsContract.StreamItemPhotos} chứa các hàng ảnh cho một mục dòng đơn. </p> <h3 id="SocialStreamInteraction">Tương tác từ luồng xã hội</h3> @@ -1998,8 +1998,8 @@ mà cung cấp dữ liệu cụ thể cho <li> Bằng cách đồng bộ dịch vụ mạng xã hội của bạn với Trình cung cấp Danh bạ bằng một trình điều hợp đồng bộ, bạn có thể truy xuất hoạt động gần đây đối với danh bạ của một người dùng và lưu giữ nó trong - các bảng {@link android.provider.ContactsContract.StreamItems} và - {@link android.provider.ContactsContract.StreamItemPhotos} để sử dụng sau. + các bảng {@code android.provider.ContactsContract.StreamItems} và + {@code android.provider.ContactsContract.StreamItemPhotos} để sử dụng sau. </li> <li> Bên cạnh việc đồng bộ hoá thường xuyên, bạn có thể kích khởi trình điều hợp đồng bộ của mình để truy xuất @@ -2330,7 +2330,7 @@ mà cung cấp dữ liệu cụ thể cho {@link android.provider.ContactsContract.CommonDataKinds.Photo#CONTENT_ITEM_TYPE Photo.CONTENT_ITEM_TYPE}. Cột {@link android.provider.ContactsContract.RawContactsColumns#CONTACT_ID} của hàng được liên kết với cột - {@link android.provider.BaseColumns#_ID} của liên lạc thô mà nó thuộc về. + {@code android.provider.BaseColumns#_ID} của liên lạc thô mà nó thuộc về. Lớp {@link android.provider.ContactsContract.Contacts.Photo} định nghĩa một bảng con của {@link android.provider.ContactsContract.Contacts} chứa thông tin ảnh về ảnh chính của một liên lạc, đây là ảnh chính của liên lạc thô chính của liên lạc. Tương tự, @@ -2344,13 +2344,13 @@ mà cung cấp dữ liệu cụ thể cho việc truy xuất thông tin ảnh. Không có lớp thuận tiện cho việc truy xuất hình thu nhỏ chính đối với một liên lạc thô, nhưng bạn có thể gửi một truy vấn tới bảng {@link android.provider.ContactsContract.Data}, chọn - {@link android.provider.BaseColumns#_ID} của liên lạc thô, + {@code android.provider.BaseColumns#_ID} của liên lạc thô, {@link android.provider.ContactsContract.CommonDataKinds.Photo#CONTENT_ITEM_TYPE Photo.CONTENT_ITEM_TYPE}, và cột {@link android.provider.ContactsContract.Data#IS_PRIMARY} để tìm hàng ảnh chính của liên lạc thô. </p> <p> Dữ liệu từ luồng xã hội đối với một người cũng có thể bao gồm ảnh. Những ảnh này được lưu giữ trong bảng - {@link android.provider.ContactsContract.StreamItemPhotos}, được mô tả chi tiết hơn + {@code android.provider.ContactsContract.StreamItemPhotos}, được mô tả chi tiết hơn trong phần <a href="#StreamPhotos">Ảnh từ luồng xã hội</a>. </p> diff --git a/docs/html-intl/intl/zh-cn/guide/components/intents-filters.jd b/docs/html-intl/intl/zh-cn/guide/components/intents-filters.jd index 7853eb103e85..1c11a5b96095 100644 --- a/docs/html-intl/intl/zh-cn/guide/components/intents-filters.jd +++ b/docs/html-intl/intl/zh-cn/guide/components/intents-filters.jd @@ -45,7 +45,7 @@ page.tags="IntentFilter" <p>{@link android.content.Intent} 是一个消息传递对象，您可以使用它从其他<a href="{@docRoot}guide/components/fundamentals.html#Components">应用组件</a>请求操作。尽管 - Intent + Intent 可以通过多种方式促进组件之间的通信，但其基本用例主要包括以下三个：</p> <ul> @@ -93,7 +93,7 @@ android.content.Context#sendStickyBroadcast sendStickyBroadcast()}，您可以 <ul> <li><b>显式 - Intent </b>：按名称（完全限定类名）指定要启动的组件。通常，您会在自己的应用中使用显式 Intent + Intent </b>：按名称（完全限定类名）指定要启动的组件。通常，您会在自己的应用中使用显式 Intent 来启动组件，这是因为您知道要启动的 Activity 或服务的类名。例如，启动新 Activity 以响应用户操作，或者启动服务以在后台下载文件。 </li> @@ -113,20 +113,20 @@ android.content.Context#sendStickyBroadcast sendStickyBroadcast()}，您可以 Intent 如何通过系统传递以启动其他 Activity 的图解：<b>[1]</b> Activity A 创建包含操作描述的 {@link android.content.Intent}，并将其传递给 {@link android.content.Context#startActivity startActivity()}。<b>[2]</b> -Android 系统搜索所有应用中与 Intent 匹配的 Intent 过滤器。<em></em>找到匹配项之后，<b>[3]</b> 该系统通过调用匹配 Activity（Activity +Android 系统搜索所有应用中与 Intent 匹配的 Intent 过滤器。<em></em>找到匹配项之后，<b>[3]</b> 该系统通过调用匹配 Activity（Activity B）的 {@link android.app.Activity#onCreate onCreate()} 方法并将其传递给 {@link android.content.Intent}，以此启动匹配 Activity。<em></em> </p> </div> -<p>创建隐式 Intent +<p>创建隐式 Intent 时，Android 系统通过将 Intent 的内容与在设备上其他应用的<a href="{@docRoot}guide/topics/manifest/manifest-intro.html">清单文件</a>中声明的 - Intent 过滤器进行比较，从而找到要启动的相应组件。<em></em>{@link android.content.Intent}如果 Intent 与 Intent + Intent 过滤器进行比较，从而找到要启动的相应组件。<em></em>{@link android.content.Intent}如果 Intent 与 Intent 过滤器匹配，则系统将启动该组件，并将其传递给对象。如果多个 Intent 过滤器兼容，则系统会显示一个对话框，支持用户选取要使用的应用。</p> -<p>Intent -过滤器是应用清单文件中的一个表达式，它指定该组件要接收的 Intent +<p>Intent +过滤器是应用清单文件中的一个表达式，它指定该组件要接收的 Intent 类型。例如，通过为 Activity 声明 Intent 过滤器，您可以使其他应用能够直接使用某一特定类型的 Intent 启动 Activity。同样，如果您没有为 Activity 声明任何 Intent 过滤器，则 Activity 只能通过显式 @@ -137,7 +137,7 @@ android.app.Activity#onCreate onCreate()} 方法并将其传递给 {@link androi Intent，且不要为服务声明 Intent 过滤器。使用隐式 Intent 启动服务存在安全隐患，因为您无法确定哪些服务将响应 Intent，且用户无法看到哪些服务已启动。从 Android 5.0（API 级别 21）开始，如果使用隐式 - Intent + Intent 调用 {@link android.content.Context#bindService bindService()}，系统会抛出异常。</p> @@ -195,7 +195,7 @@ extra 中包含的内容。 <dl> <dt>{@link android.content.Intent#ACTION_VIEW}</dt> <dd>如果您拥有一些某项 Activity 可向用户显示的信息（例如，要使用图库应用查看的照片；或者要使用地图应用查找的地址），请使用 - Intent + Intent 将此操作与 {@link android.content.Context#startActivity startActivity()} 结合使用。</dd> @@ -247,7 +247,7 @@ URI 和 MIME 类型。</p> </dd> <p><dt><b>类别</b></dt> -<dd>一个包含应处理 Intent +<dd>一个包含应处理 Intent 组件类型的附加信息的字符串。您可以将任意数量的类别描述放入一个 Intent 中，但大多数 Intent 均不需要类别。以下是一些常见类别： @@ -275,7 +275,7 @@ URI 和 MIME 类型。</p> Intent 的既定特征。通过读取这些属性，Android 系统能够解析应当启动哪个应用组件。</p> -<p>但是，Intent +<p>但是，Intent 也有可能会一些携带不影响其如何解析为应用组件的信息。Intent 还可以提供：</p> <dl> @@ -320,7 +320,7 @@ android.content.Intent#putExtras putExtras()} 将 <p>显式 Intent 是指用于启动某个特定应用组件（例如，应用中的某个特定 Activity 或服务）的 Intent。要创建显式 Intent，请为 -{@link android.content.Intent} 对象定义组件名称。Intent +{@link android.content.Intent} 对象定义组件名称。Intent 的所有其他属性均为可选属性。</p> <p>例如，如果在应用中构建了一个名为 @@ -373,9 +373,7 @@ resolveActivity()}。如果结果为非空，则至少有一个应用能够处 Intent sendIntent = new Intent(); sendIntent.setAction(Intent.ACTION_SEND); sendIntent.putExtra(Intent.EXTRA_TEXT, textMessage); -sendIntent.setType({@link - org.apache.http.protocol.HTTP#PLAIN_TEXT_TYPE - HTTP.PLAIN_TEXT_TYPE}); // "text/plain" MIME type +sendIntent.setType("text/plain"); // Verify that the intent will resolve to an activity if (sendIntent.resolveActivity(getPackageManager()) != null) { @@ -527,7 +525,7 @@ URI（<code>scheme</code>、<code>host</code>、<code>port</code>、<code>path</ <h2>限制对组件的访问</h2> <p>使用 Intent 过滤器时，无法安全地防止其他应用启动组件。尽管 - Intent + Intent 过滤器将组件限制为仅响应特定类型的隐式 Intent，但如果开发者确定您的组件名称，则其他应用有可能通过使用显式 Intent 启动您的应用组件。如果必须确保只有您自己的应用才能启动您的某一组件，请针对该组件将 <a href="{@docRoot}guide/topics/manifest/activity-element.html#exported">{@code exported}</a> @@ -540,7 +538,7 @@ exported}</a> Intent 与所有这三个元素进行比较，根据过滤器测试隐式 Intent。隐式 Intent 若要传递给组件，必须通过所有这三项测试。如果 Intent 甚至无法匹配其中任何一项测试，则 Android 系统不会将其传递给组件。但是，由于一个组件可能有多个 - Intent + Intent 过滤器，因此未能通过某一组件过滤器的 Intent 可能会通过另一过滤器。如需了解有关系统如何解析 Intent 的详细信息，请参阅下文的 <a href="#Resolution"> Intent 解析</a>部分。</p> @@ -613,7 +611,7 @@ android.content.Context#unregisterReceiver unregisterReceiver()} 注销该接收 Intent（与两个 Intent 过滤器之一匹配）的另一应用中直接进入 {@code ShareActivity}。</p> -<p class="note"><strong>注意：</strong>MIME 类型 +<p class="note"><strong>注意：</strong>MIME 类型 <a href="https://developers.google.com/panorama/android/">{@code application/vnd.google.panorama360+jpg}</a> 是一个指定全景照片的特殊 数据类型，您可以使用 <a href="{@docRoot}reference/com/google/android/gms/panorama/package-summary.html">Google @@ -741,7 +739,7 @@ startActivity()}）执行该 Intent。相反，通过调用相应的创建器方 </pre> <p>若要 Intent 通过类别测试，则 {@link android.content.Intent} -中的每个类别均必须与过滤器中的类别匹配。反之则未必然，Intent +中的每个类别均必须与过滤器中的类别匹配。反之则未必然，Intent 过滤器声明的类别可以超出 {@link android.content.Intent} 中指定的数量，且 {@link android.content.Intent} 仍会通过测试。因此，不含类别的 Intent 应当始终会通过此测试，无论过滤器中声明何种类别均是如此。</p> @@ -874,7 +872,7 @@ Android <h3 id="imatch"> Intent 匹配</h3> <p>通过 - Intent + Intent 过滤器匹配 Intent，这不仅有助于发现要激活的目标组件，还有助于发现设备上组件集的相关信息。例如，主页应用通过使用指定 {@link android.content.Intent#ACTION_MAIN} 操作和 {@link android.content.Intent#CATEGORY_LAUNCHER} 类别的 @@ -882,8 +880,8 @@ Android <p>您的应用可以采用类似的方式使用 Intent 匹配。{@link android.content.pm.PackageManager} 提供了一整套 {@code query...()} -方法来返回所有能够接受特定 Intent -的组件。此外，它还提供了一系列类似的 {@code resolve...()} 方法来确定响应 Intent +方法来返回所有能够接受特定 Intent +的组件。此外，它还提供了一系列类似的 {@code resolve...()} 方法来确定响应 Intent 的最佳组件。例如，{@link android.content.pm.PackageManager#queryIntentActivities queryIntentActivities()} 将返回能够执行那些作为参数传递的 diff --git a/docs/html-intl/intl/zh-cn/guide/topics/providers/contacts-provider.jd b/docs/html-intl/intl/zh-cn/guide/topics/providers/contacts-provider.jd index 37d472d40deb..7125fb983d54 100644 --- a/docs/html-intl/intl/zh-cn/guide/topics/providers/contacts-provider.jd +++ b/docs/html-intl/intl/zh-cn/guide/topics/providers/contacts-provider.jd @@ -57,7 +57,7 @@ page.title=联系人提供程序 <li>{@link android.provider.ContactsContract.Contacts}</li> <li>{@link android.provider.ContactsContract.RawContacts}</li> <li>{@link android.provider.ContactsContract.Data}</li> - <li>{@link android.provider.ContactsContract.StreamItems}</li> + <li>{@code android.provider.ContactsContract.StreamItems}</li> </ol> <h2>相关示例</h2> <ol> @@ -169,7 +169,7 @@ page.title=联系人提供程序 原始联系人的大部分数据并不存储在 {@link android.provider.ContactsContract.RawContacts} 表内，而是存储在 {@link android.provider.ContactsContract.Data} 表中的一行或多行内。每个数据行都有一个 -{@link android.provider.ContactsContract.DataColumns#RAW_CONTACT_ID Data.RAW_CONTACT_ID} 列，其中包含其父级 {@link android.provider.ContactsContract.RawContacts} 行的 {@link android.provider.BaseColumns#_ID RawContacts._ID} 值。 +{@link android.provider.ContactsContract.DataColumns#RAW_CONTACT_ID Data.RAW_CONTACT_ID} 列，其中包含其父级 {@link android.provider.ContactsContract.RawContacts} 行的 {@code android.provider.BaseColumns#_ID RawContacts._ID} 值。 </p> @@ -482,15 +482,15 @@ page.title=联系人提供程序 </p> <p> {@link android.provider.ContactsContract.Contacts} 表还有一个 -{@link android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} 列，它是一个指向联系人行的“永久性”链接。 -由于联系人提供程序会自动维护联系人，因此可能会在合并或同步时相应地更改联系人行的 {@link android.provider.BaseColumns#_ID} 值。 +{@code android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} 列，它是一个指向联系人行的“永久性”链接。 +由于联系人提供程序会自动维护联系人，因此可能会在合并或同步时相应地更改联系人行的 {@code android.provider.BaseColumns#_ID} 值。 即使发生这种情况，合并了联系人 -{@link android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} 的内容 URI +{@code android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} 的内容 URI {@link android.provider.ContactsContract.Contacts#CONTENT_LOOKUP_URI} 仍将指向联系人行，这样，您就能使用 -{@link android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} +{@code android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} 保持指向“最喜爱”联系人的链接，以及执行其他操作。 -该列具有其自己的格式，与 {@link android.provider.BaseColumns#_ID} 列的格式无关。 +该列具有其自己的格式，与 {@code android.provider.BaseColumns#_ID} 列的格式无关。 </p> <p> @@ -600,13 +600,13 @@ page.title=联系人提供程序 <p> 访问用户个人资料需要特殊权限。除了进行读取和写入所需的 {@link android.Manifest.permission#READ_CONTACTS} 和 -{@link android.Manifest.permission#WRITE_CONTACTS} 权限外，如果想访问用户个人资料，还分别需要 {@link android.Manifest.permission#READ_PROFILE} 和 -{@link android.Manifest.permission#WRITE_PROFILE} 权限进行读取和写入访问。 +{@link android.Manifest.permission#WRITE_CONTACTS} 权限外，如果想访问用户个人资料，还分别需要 {@code android.Manifest.permission#READ_PROFILE} 和 +{@code android.Manifest.permission#WRITE_PROFILE} 权限进行读取和写入访问。 </p> <p> - 请切记，您应该将用户的个人资料视为敏感数据。{@link android.Manifest.permission#READ_PROFILE} 权限让您可以访问设备用户的个人身份识别数据。 + 请切记，您应该将用户的个人资料视为敏感数据。{@code android.Manifest.permission#READ_PROFILE} 权限让您可以访问设备用户的个人身份识别数据。 请务必在您的应用的描述中告知用户您需要用户个人资料访问权限的原因。 @@ -977,7 +977,7 @@ onLoadFinished()} 回调。此方法的传入参数之一是一个 <p> 当您将一个新原始联系人行及其关联的数据行作为一组 {@link android.content.ContentProviderOperation} 对象插入时，需要通过将原始联系人的 -{@link android.provider.BaseColumns#_ID} 值作为 +{@code android.provider.BaseColumns#_ID} 值作为 {@link android.provider.ContactsContract.DataColumns#RAW_CONTACT_ID} 值插入，将数据行链接到原始联系人行。 不过，当您为数据行创建 {@link android.content.ContentProviderOperation} 时，该值不可用，因为您尚未对原始联系人行应用 @@ -1011,7 +1011,7 @@ onLoadFinished()} 回调。此方法的传入参数之一是一个 <code>previousResult</code> 值是其中一个结果的索引，它通过 <code>key</code> 值进行检索和存储。 这样，您就可以插入一条新的原始联系人记录，并取回其 -{@link android.provider.BaseColumns#_ID} 值，然后在添加 {@link android.provider.ContactsContract.Data} 行时“向后引用”该值。 +{@code android.provider.BaseColumns#_ID} 值，然后在添加 {@link android.provider.ContactsContract.Data} 行时“向后引用”该值。 <p> 系统会在您首次调用 @@ -1089,7 +1089,7 @@ protected void createContactEntry() { 每个操作生成器对象都使用 {@link android.content.ContentProviderOperation.Builder#withValueBackReference(String, int) withValueBackReference()} 来获取 -{@link android.provider.ContactsContract.DataColumns#RAW_CONTACT_ID}。引用指回来自第一次操作的 {@link android.content.ContentProviderResult} 对象，第一次操作就是添加原始联系人行并返回其新 {@link android.provider.BaseColumns#_ID} +{@link android.provider.ContactsContract.DataColumns#RAW_CONTACT_ID}。引用指回来自第一次操作的 {@link android.content.ContentProviderResult} 对象，第一次操作就是添加原始联系人行并返回其新 {@code android.provider.BaseColumns#_ID} 值。 结果是，每个数据行都通过其 @@ -1228,7 +1228,7 @@ withYieldAllowed()} 标志，用于设置屈服点： <li> 创建一个适合使用 {@link android.content.ContentProviderOperation#newAssertQuery(Uri)} 方法强制执行约束 -的 {@link android.content.ContentProviderOperation.Builder} 对象。对于内容 URI，请使用追加有原始联系人 {@link android.provider.BaseColumns#_ID} 的 {@link android.provider.ContactsContract.RawContacts#CONTENT_URI +的 {@link android.content.ContentProviderOperation.Builder} 对象。对于内容 URI，请使用追加有原始联系人 {@code android.provider.BaseColumns#_ID} 的 {@link android.provider.ContactsContract.RawContacts#CONTENT_URI RawContacts.CONTENT_URI} 。 @@ -1821,8 +1821,8 @@ XML 文件 <code>res/xml/syncadapter.xml</code>。而该文件则指定将与联 </dl> <h2 id="SocialStream">社交流数据</h2> <p> - {@link android.provider.ContactsContract.StreamItems} 表和 -{@link android.provider.ContactsContract.StreamItemPhotos} 表管理来自社交网络的传入数据。 + {@code android.provider.ContactsContract.StreamItems} 表和 +{@code android.provider.ContactsContract.StreamItemPhotos} 表管理来自社交网络的传入数据。 您可以编写一个同步适配器，用其将您自己社交网络中的流数据添加到这些表中，也可以从这些表读取流数据并将其显示在您的自有应用中，或者同时采用这两种方法。 利用这些功能，可以将您的社交网络服务和应用集成到 Android 的社交网络体验之中。 @@ -1831,7 +1831,7 @@ XML 文件 <code>res/xml/syncadapter.xml</code>。而该文件则指定将与联 <h3 id="StreamText">社交流文本</h3> <p> 流项目始终与原始联系人关联。 -{@link android.provider.ContactsContract.StreamItemsColumns#RAW_CONTACT_ID} 链接到原始联系人的 <code>_ID</code> 值。 +{@code android.provider.ContactsContract.StreamItemsColumns#RAW_CONTACT_ID} 链接到原始联系人的 <code>_ID</code> 值。 原始联系人的帐户类型和帐户名称也存储在流项目行中。 </p> @@ -1840,14 +1840,14 @@ XML 文件 <code>res/xml/syncadapter.xml</code>。而该文件则指定将与联 </p> <dl> <dt> - {@link android.provider.ContactsContract.StreamItemsColumns#ACCOUNT_TYPE} + {@code android.provider.ContactsContract.StreamItemsColumns#ACCOUNT_TYPE} </dt> <dd> <strong>必备。</strong>与该流项目关联的原始联系人对应的用户帐户类型。 请记得在插入流项目时设置此值。 </dd> <dt> - {@link android.provider.ContactsContract.StreamItemsColumns#ACCOUNT_NAME} + {@code android.provider.ContactsContract.StreamItemsColumns#ACCOUNT_NAME} </dt> <dd> <strong>必备。</strong>与该流项目关联的原始联系人对应的用户帐户名称。 @@ -1861,30 +1861,30 @@ XML 文件 <code>res/xml/syncadapter.xml</code>。而该文件则指定将与联 <ul> <li> - {@link android.provider.ContactsContract.StreamItemsColumns#CONTACT_ID}：此流项目关联的联系人的 -{@link android.provider.BaseColumns#_ID} 值。 + {@code android.provider.ContactsContract.StreamItemsColumns#CONTACT_ID}：此流项目关联的联系人的 +{@code android.provider.BaseColumns#_ID} 值。 </li> <li> - {@link android.provider.ContactsContract.StreamItemsColumns#CONTACT_LOOKUP_KEY}：此流项目关联的联系人的 -{@link android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} 值。 + {@code android.provider.ContactsContract.StreamItemsColumns#CONTACT_LOOKUP_KEY}：此流项目关联的联系人的 +{@code android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} 值。 </li> <li> - {@link android.provider.ContactsContract.StreamItemsColumns#RAW_CONTACT_ID}：此流项目关联的原始联系人的 -{@link android.provider.BaseColumns#_ID} 值。 + {@code android.provider.ContactsContract.StreamItemsColumns#RAW_CONTACT_ID}：此流项目关联的原始联系人的 +{@code android.provider.BaseColumns#_ID} 值。 </li> </ul> </dd> <dt> - {@link android.provider.ContactsContract.StreamItemsColumns#COMMENTS} + {@code android.provider.ContactsContract.StreamItemsColumns#COMMENTS} </dt> <dd> 可选。存储可在流项目开头显示的摘要信息。 </dd> <dt> - {@link android.provider.ContactsContract.StreamItemsColumns#TEXT} + {@code android.provider.ContactsContract.StreamItemsColumns#TEXT} </dt> <dd> 流项目的文本，或为项目来源发布的内容，或是对生成流项目的某项操作的描述。 @@ -1894,7 +1894,7 @@ XML 文件 <code>res/xml/syncadapter.xml</code>。而该文件则指定将与联 </dd> <dt> - {@link android.provider.ContactsContract.StreamItemsColumns#TIMESTAMP} + {@code android.provider.ContactsContract.StreamItemsColumns#TIMESTAMP} </dt> <dd> 一个包含流项目插入时间或更新时间的文本字符串，以从公元纪年开始计算的<em>毫秒数</em>形式表示。 @@ -1905,42 +1905,42 @@ XML 文件 <code>res/xml/syncadapter.xml</code>。而该文件则指定将与联 </dl> <p> 要显示您的流项目的标识信息，请使用 -{@link android.provider.ContactsContract.StreamItemsColumns#RES_ICON}、 -{@link android.provider.ContactsContract.StreamItemsColumns#RES_LABEL} 和 -{@link android.provider.ContactsContract.StreamItemsColumns#RES_PACKAGE} 链接到您的应用中的资源。 +{@code android.provider.ContactsContract.StreamItemsColumns#RES_ICON}、 +{@code android.provider.ContactsContract.StreamItemsColumns#RES_LABEL} 和 +{@code android.provider.ContactsContract.StreamItemsColumns#RES_PACKAGE} 链接到您的应用中的资源。 </p> <p> - {@link android.provider.ContactsContract.StreamItems} 表还包含供同步适配器专用的列 -{@link android.provider.ContactsContract.StreamItemsColumns#SYNC1} 至 -{@link android.provider.ContactsContract.StreamItemsColumns#SYNC4}。 + {@code android.provider.ContactsContract.StreamItems} 表还包含供同步适配器专用的列 +{@code android.provider.ContactsContract.StreamItemsColumns#SYNC1} 至 +{@code android.provider.ContactsContract.StreamItemsColumns#SYNC4}。 </p> <h3 id="StreamPhotos">社交流照片</h3> <p> - {@link android.provider.ContactsContract.StreamItemPhotos} 表存储与流项目关联的照片。 + {@code android.provider.ContactsContract.StreamItemPhotos} 表存储与流项目关联的照片。 该表的 -{@link android.provider.ContactsContract.StreamItemPhotosColumns#STREAM_ITEM_ID}列链接到 {@link android.provider.ContactsContract.StreamItems} 表 {@link android.provider.BaseColumns#_ID} 列中的值。 +{@code android.provider.ContactsContract.StreamItemPhotosColumns#STREAM_ITEM_ID}列链接到 {@code android.provider.ContactsContract.StreamItems} 表 {@code android.provider.BaseColumns#_ID} 列中的值。 照片引用存储在表中的以下列： </p> <dl> <dt> - {@link android.provider.ContactsContract.StreamItemPhotos#PHOTO} 列（一个二进制大型对象）。 + {@code android.provider.ContactsContract.StreamItemPhotos#PHOTO} 列（一个二进制大型对象）。 </dt> <dd> 照片的二进制表示，为便于存储和显示，由提供程序调整了尺寸。 此列可用于向后兼容使用它来存储照片的旧版本联系人提供程序。 不过，在当前版本中，您不应使用此列来存储照片， 而应使用 -{@link android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_FILE_ID} 或 -{@link android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_URI}（下文对两者都做了描述）将照片存储在一个文件内。 +{@code android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_FILE_ID} 或 +{@code android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_URI}（下文对两者都做了描述）将照片存储在一个文件内。 此列现在包含可用于读取的照片缩略图。 </dd> <dt> - {@link android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_FILE_ID} + {@code android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_FILE_ID} </dt> <dd> 原始联系人照片的数字标识符。将此值追加到常量 @@ -1950,7 +1950,7 @@ openAssetFileDescriptor()} 来获取照片文件的句柄。 </dd> <dt> - {@link android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_URI} + {@code android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_URI} </dt> <dd> 一个内容 URI，直接指向此行所表示的照片的照片文件。 @@ -1964,28 +1964,28 @@ openAssetFileDescriptor()} 以获得照片文件的句柄。 </p> <ul> <li> - 这些表需要额外的访问权限。要读取它们的数据，您的应用必须具有 {@link android.Manifest.permission#READ_SOCIAL_STREAM} 权限。 + 这些表需要额外的访问权限。要读取它们的数据，您的应用必须具有 {@code android.Manifest.permission#READ_SOCIAL_STREAM} 权限。 要修改它们，您的应用必须具有 -{@link android.Manifest.permission#WRITE_SOCIAL_STREAM} 权限。 +{@code android.Manifest.permission#WRITE_SOCIAL_STREAM} 权限。 </li> <li> - 对于 {@link android.provider.ContactsContract.StreamItems} 表，为每一位原始联系人存储的行数有限。 + 对于 {@code android.provider.ContactsContract.StreamItems} 表，为每一位原始联系人存储的行数有限。 一旦达到该限制，联系人提供程序即会自动删除 -{@link android.provider.ContactsContract.StreamItemsColumns#TIMESTAMP} 最早的行，为新流项目行腾出空间。 +{@code android.provider.ContactsContract.StreamItemsColumns#TIMESTAMP} 最早的行，为新流项目行腾出空间。 要获取该限制，请发出对内容 URI -{@link android.provider.ContactsContract.StreamItems#CONTENT_LIMIT_URI} 的查询。 +{@code android.provider.ContactsContract.StreamItems#CONTENT_LIMIT_URI} 的查询。 您可以将内容 URI 以外的所有其他参数保持设置为 <code>null</code>。 查询会返回一个 Cursor，其中包含一行，并且只有 -{@link android.provider.ContactsContract.StreamItems#MAX_ITEMS} 一列。 +{@code android.provider.ContactsContract.StreamItems#MAX_ITEMS} 一列。 </li> </ul> <p> - {@link android.provider.ContactsContract.StreamItems.StreamItemPhotos} 类定义了 - {@link android.provider.ContactsContract.StreamItemPhotos} 的一个子表，其中包含某个流项目的照片行。 + {@code android.provider.ContactsContract.StreamItems.StreamItemPhotos} 类定义了 + {@code android.provider.ContactsContract.StreamItemPhotos} 的一个子表，其中包含某个流项目的照片行。 </p> <h3 id="SocialStreamInteraction">社交流交互</h3> @@ -1997,8 +1997,8 @@ openAssetFileDescriptor()} 以获得照片文件的句柄。 <ul> <li> 您可以通过同步适配器让您的社交网络服务与联系人提供程序同步，检索用户联系人的近期 Activity，并将其存储在 - {@link android.provider.ContactsContract.StreamItems} 表和 -{@link android.provider.ContactsContract.StreamItemPhotos} 表中，以供日后使用。 + {@code android.provider.ContactsContract.StreamItems} 表和 +{@code android.provider.ContactsContract.StreamItemPhotos} 表中，以供日后使用。 </li> <li> @@ -2330,7 +2330,7 @@ Settings.UNGROUPED_VISIBLE} 列的值设置为 1。执行此操作后，即使 {@link android.provider.ContactsContract.CommonDataKinds.Photo#CONTENT_ITEM_TYPE Photo.CONTENT_ITEM_TYPE} 以行的形式存储照片。该行的 {@link android.provider.ContactsContract.RawContactsColumns#CONTACT_ID} 列链接到其所属原始联系人的 -{@link android.provider.BaseColumns#_ID} 列。 +{@code android.provider.BaseColumns#_ID} 列。 {@link android.provider.ContactsContract.Contacts.Photo} 类定义了一个 {@link android.provider.ContactsContract.Contacts} 子表，其中包含联系人主要照片（联系人的主要原始联系人的主要照片）的照片信息。 同样， @@ -2343,7 +2343,7 @@ Photo.CONTENT_ITEM_TYPE} 以行的形式存储照片。该行的 {@link android.provider.ContactsContract.RawContacts.DisplayPhoto} 参考文档包含检索照片信息的示例。 并没有可用来检索原始联系人主要缩略图的实用类，但您可以向 {@link android.provider.ContactsContract.Data} 表发送查询，从而通过选定原始联系人的 -{@link android.provider.BaseColumns#_ID}、 +{@code android.provider.BaseColumns#_ID}、 {@link android.provider.ContactsContract.CommonDataKinds.Photo#CONTENT_ITEM_TYPE Photo.CONTENT_ITEM_TYPE} 以及 {@link android.provider.ContactsContract.Data#IS_PRIMARY} 列，找到原始联系人的主要照片行。 @@ -2351,6 +2351,6 @@ Photo.CONTENT_ITEM_TYPE} 以及 {@link android.provider.ContactsContract.Data#IS </p> <p> 联系人的社交流数据也可能包含照片。这些照片存储在 -{@link android.provider.ContactsContract.StreamItemPhotos} 表中，<a href="#StreamPhotos">社交流照片</a>部分对该表做了更详尽的描述。 +{@code android.provider.ContactsContract.StreamItemPhotos} 表中，<a href="#StreamPhotos">社交流照片</a>部分对该表做了更详尽的描述。 </p> diff --git a/docs/html-intl/intl/zh-tw/guide/components/intents-filters.jd b/docs/html-intl/intl/zh-tw/guide/components/intents-filters.jd index 8e19048fc74e..d3edac3f817a 100644 --- a/docs/html-intl/intl/zh-tw/guide/components/intents-filters.jd +++ b/docs/html-intl/intl/zh-tw/guide/components/intents-filters.jd @@ -230,12 +230,12 @@ setAction()} 或 {@link android.content.Intent} 建構函式來指定意圖的 例如，能夠顯示影像的 Activity 可能無法播放音訊檔案，即使有類似的 URI 格式。 因此，指定資料的 MIME 格式可協助 Android 系統找出最適合接收意圖的元件。 -不過 — 尤其是當資料指出資料位在裝置何處且受 -{@link android.content.ContentProvider} 控制讓系統看見資料 MIME 類型的 +不過 — 尤其是當資料指出資料位在裝置何處且受 +{@link android.content.ContentProvider} 控制讓系統看見資料 MIME 類型的 {@code content:} URI 時，有時能夠從 URI 推論出 MIME 類型。</p> <p>如果您只想設定資料 URI，請呼叫 {@link android.content.Intent#setData setData()}。 -如要設定 MIME 類型，請呼叫 {@link android.content.Intent#setType setType()}。您還可以視需要利用 +如要設定 MIME 類型，請呼叫 {@link android.content.Intent#setType setType()}。您還可以視需要利用 {@link android.content.Intent#setDataAndType setDataAndType()} 明確設定兩者。</p> @@ -373,9 +373,7 @@ resolveActivity()}。如果結果不是 null，表示至少有一個應用程式 Intent sendIntent = new Intent(); sendIntent.setAction(Intent.ACTION_SEND); sendIntent.putExtra(Intent.EXTRA_TEXT, textMessage); -sendIntent.setType({@link - org.apache.http.protocol.HTTP#PLAIN_TEXT_TYPE - HTTP.PLAIN_TEXT_TYPE}); // "text/plain" MIME type +sendIntent.setType("text/plain"); // Verify that the intent will resolve to an activity if (sendIntent.resolveActivity(getPackageManager()) != null) { @@ -491,7 +489,7 @@ android.content.Intent#createChooser createChooser()} 方法)，並使用提供 {@link android.app.Activity#startActivity startActivity()} 與 -{@link android.app.Activity#startActivityForResult startActivityForResult()} 方法對所有意圖進行處理時，就像已宣告 +{@link android.app.Activity#startActivityForResult startActivityForResult()} 方法對所有意圖進行處理時，就像已宣告 {@link android.content.Intent#CATEGORY_DEFAULT} 類別一樣。 如果您未在意圖篩選器中宣告此類別，任何隱含意圖都不會解析為 Activity。 </p> @@ -511,9 +509,9 @@ android.content.Intent#createChooser createChooser()} 方法)，並使用提供 </activity> </pre> -<p>想要建立包含多個 +<p>想要建立包含多個 <a href="{@docRoot}guide/topics/manifest/action-element.html">{@code <action>}</a>、 -<a href="{@docRoot}guide/topics/manifest/data-element.html">{@code <data>}</a> 或 +<a href="{@docRoot}guide/topics/manifest/data-element.html">{@code <data>}</a> 或 <a href="{@docRoot}guide/topics/manifest/category-element.html">{@code <category>}</a> 執行個體的篩選器也沒關係。 如果您這樣做，只需要確定該元件能處理這些篩選器元素的任何組合。 </p> @@ -529,7 +527,7 @@ android.content.Intent#createChooser createChooser()} 方法)，並使用提供 雖然意圖篩選器限制元件只能回應特定的隱含意圖，如果開發人員決定您的元件名稱，另一款應用程式還是有可能使用明確意圖來啟動您的應用程式元件。 -如果必須「限定只有您自己的應用程式」<em></em>才能啟動您的元件，請將該元件的 +如果必須「限定只有您自己的應用程式」<em></em>才能啟動您的元件，請將該元件的 <a href="{@docRoot}guide/topics/manifest/activity-element.html#exported">{@code exported}</a> 屬性設定為 {@code "false"}。 </p> @@ -550,7 +548,7 @@ exported}</a> 屬性設定為 {@code "false"}。 <p class="note"><strong>注意：</strong>對於所有 Activity，您都必須在宣示說明檔案中宣告意圖篩選器。 -不過，廣播接收器的篩選器可以藉由呼叫 +不過，廣播接收器的篩選器可以藉由呼叫 {@link android.content.Context#registerReceiver(BroadcastReceiver, IntentFilter, String, Handler) registerReceiver()} 進行動態註冊。您之後可以利用 {@link android.content.Context#unregisterReceiver unregisterReceiver()} 來取消註冊接收器。這樣做可在您的應用程式執行時，讓應用程式只能在指定期間內接聽特定廣播。 @@ -615,7 +613,7 @@ android.content.Context#unregisterReceiver unregisterReceiver()} 來取消註冊 <p class="note"><strong>注意：</strong> <a href="https://developers.google.com/panorama/android/">{@code -application/vnd.google.panorama360+jpg}</a> MIME 類型是指定全景相片的特殊資料類型，您可以透過 +application/vnd.google.panorama360+jpg}</a> MIME 類型是指定全景相片的特殊資料類型，您可以透過 <a href="{@docRoot}reference/com/google/android/gms/panorama/package-summary.html">Google 全景</a> API 來處理。 </p> @@ -654,7 +652,7 @@ android.content.Intent} 物件的包裝函式。{@link android.app.PendingIntent <p>由於每個 {@link android.content.Intent} 物件都設計為要由特定的應用程式元件類型來處理 ({@link android.app.Activity}、{@link android.app.Service} 或 {@link android.content.BroadcastReceiver})，因此請務必以相同的考量建立 {@link android.app.PendingIntent}。 -使用待處理意圖時，您的應用程式將不會透過像是 +使用待處理意圖時，您的應用程式將不會透過像是 {@link android.content.Context#startActivity startActivity()} 的呼叫來執行意圖。當您藉由呼叫以下的個別建立者方法建立 {@link android.app.PendingIntent} 時，您必須改為宣告意圖元件類型：</p> @@ -704,7 +702,7 @@ startActivity()} 的呼叫來執行意圖。當您藉由呼叫以下的個別建 <h3 id="ActionTest">動作測試</h3> -<p>如要指定接受的意圖動作，意圖篩選器可以宣告零或多個 +<p>如要指定接受的意圖動作，意圖篩選器可以宣告零或多個 <a href="{@docRoot}guide/topics/manifest/action-element.html">{@code <action>}</a> 元素。例如：</p> @@ -728,7 +726,7 @@ startActivity()} 的呼叫來執行意圖。當您藉由呼叫以下的個別建 <h3 id="CategoryTest">類別測試</h3> -<p>如要指定接受的意圖類別，意圖篩選器可以宣告零或多個 +<p>如要指定接受的意圖類別，意圖篩選器可以宣告零或多個 <a href="{@docRoot}guide/topics/manifest/category-element.html">{@code <category>}</a> 元素。例如：</p> @@ -741,14 +739,14 @@ startActivity()} 的呼叫來執行意圖。當您藉由呼叫以下的個別建 </pre> <p>{@link android.content.Intent} 中的每個類別都必須與篩選器中的類別相符，意圖才會通過類別測試。 -不需要反向進行 — 意圖篩選器宣告的類別可以比 +不需要反向進行 — 意圖篩選器宣告的類別可以比 {@link android.content.Intent} 中指定的類別多，而 {@link android.content.Intent} 仍可通過測試。因此，不論篩選器中宣告的類別為何，未包含類別的意圖一律可通過此測試。 </p> <p class="note"><strong>注意：</strong>Android 會將 {@link android.content.Intent#CATEGORY_DEFAULT} 類別自動套用到所有傳送至 {@link android.content.Context#startActivity startActivity()} 與 {@link -android.app.Activity#startActivityForResult startActivityForResult()} 的隱含意圖。因此，如果您希望 Activity 收到隱含意圖，Activity 的意圖篩選器就必須包含 +android.app.Activity#startActivityForResult startActivityForResult()} 的隱含意圖。因此，如果您希望 Activity 收到隱含意圖，Activity 的意圖篩選器就必須包含 {@code "android.intent.category.DEFAULT"} 的類別 (如先前的 {@code <intent-filter>} 範例中所示)。 @@ -759,7 +757,7 @@ android.app.Activity#startActivityForResult startActivityForResult()} 的隱含 <h3 id="DataTest">資料測試</h3> -<p>如要指定接受的意圖資料，意圖篩選器可以宣告零或多個 +<p>如要指定接受的意圖資料，意圖篩選器可以宣告零或多個 <a href="{@docRoot}guide/topics/manifest/data-element.html">{@code <data>}</a> 元素。例如：</p> @@ -828,7 +826,7 @@ android.app.Activity#startActivityForResult startActivityForResult()} 的隱含 <li>只有在 MIME 類型與篩選器中列出的類型相符時，包含 URI 與 MIME 類型 (明確或可從 URI 推測得出) 的意圖才會通過 MIME 類型部分的測試。 -如果它的 URI 與篩選器中的 URI 相符，或如果它有 +如果它的 URI 與篩選器中的 URI 相符，或如果它有 {@code content:} 或 {@code file:} URI，而且篩選器未指定 URI 時，就會通過 URI 部分的測試。換句話說，如果它的篩選器「只」<em></em>列出 MIME 類型，就會假設元件支援 {@code content:} 與 {@code file:} 資料。 @@ -886,12 +884,12 @@ android.app.Activity#startActivityForResult startActivityForResult()} 的隱含 例如， {@link android.content.pm.PackageManager#queryIntentActivities -queryIntentActivities()} 會傳回所有 Activity 清單，上述的 Activity 都可以執行當成引數傳送的意圖，以及 +queryIntentActivities()} 會傳回所有 Activity 清單，上述的 Activity 都可以執行當成引數傳送的意圖，以及 {@link android.content.pm.PackageManager#queryIntentServices queryIntentServices()} 可傳回類似的服務清單。 -這些方法不會啟動元件，只會列出可以回應的元件。類似的方法 +這些方法不會啟動元件，只會列出可以回應的元件。類似的方法 {@link android.content.pm.PackageManager#queryBroadcastReceivers queryBroadcastReceivers()} 可用於廣播接收器。 </p> diff --git a/docs/html-intl/intl/zh-tw/guide/topics/providers/contacts-provider.jd b/docs/html-intl/intl/zh-tw/guide/topics/providers/contacts-provider.jd index e172f9aca48f..b5f888012eed 100644 --- a/docs/html-intl/intl/zh-tw/guide/topics/providers/contacts-provider.jd +++ b/docs/html-intl/intl/zh-tw/guide/topics/providers/contacts-provider.jd @@ -57,7 +57,7 @@ page.title=聯絡人供應程式 <li>{@link android.provider.ContactsContract.Contacts}</li> <li>{@link android.provider.ContactsContract.RawContacts}</li> <li>{@link android.provider.ContactsContract.Data}</li> - <li>{@link android.provider.ContactsContract.StreamItems}</li> + <li>{@code android.provider.ContactsContract.StreamItems}</li> </ol> <h2>相關範例</h2> <ol> @@ -169,7 +169,7 @@ page.title=聯絡人供應程式 原始聯絡人的大部分資料不是儲存在 {@link android.provider.ContactsContract.RawContacts} 表格，而是儲存在 {@link android.provider.ContactsContract.Data} 表格中的一或多個列。 每個資料列都有一欄 -{@link android.provider.ContactsContract.DataColumns#RAW_CONTACT_ID Data.RAW_CONTACT_ID}，當中包含其上層資料列 {@link android.provider.ContactsContract.RawContacts} 的 {@link android.provider.BaseColumns#_ID RawContacts._ID} 值。 +{@link android.provider.ContactsContract.DataColumns#RAW_CONTACT_ID Data.RAW_CONTACT_ID}，當中包含其上層資料列 {@link android.provider.ContactsContract.RawContacts} 的 {@code android.provider.BaseColumns#_ID RawContacts._ID} 值。 </p> @@ -482,15 +482,15 @@ Email.CONTENT_ITEM_TYPE} (內含使用者名稱，而不是電子郵件地址) </p> <p> {@link android.provider.ContactsContract.Contacts} 表格也有 -{@link android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} 欄，此為聯絡人列的「永久」連結。 -因為聯絡人供應程式會自動維護聯絡人，它會變更聯絡人列的 {@link android.provider.BaseColumns#_ID} 值，以回應彙總或同步操作。 +{@code android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} 欄，此為聯絡人列的「永久」連結。 +因為聯絡人供應程式會自動維護聯絡人，它會變更聯絡人列的 {@code android.provider.BaseColumns#_ID} 值，以回應彙總或同步操作。 即使發生這種情況，與聯絡人的 -{@link android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} 合併的內容 URI {@link android.provider.ContactsContract.Contacts#CONTENT_LOOKUP_URI} 仍會指向聯絡人列，因此，您可以使用 -{@link android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} +{@code android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} 合併的內容 URI {@link android.provider.ContactsContract.Contacts#CONTENT_LOOKUP_URI} 仍會指向聯絡人列，因此，您可以使用 +{@code android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} 來維護「常用聯絡人」等聯絡人的連結。 -此欄有自己的格式，與 {@link android.provider.BaseColumns#_ID} 欄的格式無關。 +此欄有自己的格式，與 {@code android.provider.BaseColumns#_ID} 欄的格式無關。 </p> <p> @@ -600,14 +600,14 @@ Email.CONTENT_ITEM_TYPE} (內含使用者名稱，而不是電子郵件地址) <p> 存取使用者設定檔需要特殊權限。除了 {@link android.Manifest.permission#READ_CONTACTS} 和 -{@link android.Manifest.permission#WRITE_CONTACTS} 的讀取和寫入權限以外，存取使用者設定檔還分別需要 {@link android.Manifest.permission#READ_PROFILE} 讀取權限和 -{@link android.Manifest.permission#WRITE_PROFILE} 寫入權限。 +{@link android.Manifest.permission#WRITE_CONTACTS} 的讀取和寫入權限以外，存取使用者設定檔還分別需要 {@code android.Manifest.permission#READ_PROFILE} 讀取權限和 +{@code android.Manifest.permission#WRITE_PROFILE} 寫入權限。 </p> <p> 請務必將使用者的設定檔視為敏感資訊。 -{@link android.Manifest.permission#READ_PROFILE}權限可以讓您存取裝置上使用者的身分識別資料。 +{@code android.Manifest.permission#READ_PROFILE}權限可以讓您存取裝置上使用者的身分識別資料。 請務必在應用程式的簡介中告訴使用者，為何需要使用者設定檔存取權限。 </p> @@ -977,7 +977,7 @@ public Loader<Cursor> onCreateLoader(int id, Bundle args) { <p> 以一組 {@link android.content.ContentProviderOperation} 物件插入新的原始聯絡人及其關聯的資料列時，您必須透過插入原始聯絡人的 - {@link android.provider.BaseColumns#_ID} 值做為 + {@code android.provider.BaseColumns#_ID} 值做為 {@link android.provider.ContactsContract.DataColumns#RAW_CONTACT_ID} 值，將資料列連結到原始聯絡人列。 不過，此 值在您為資料列建立 {@link android.content.ContentProviderOperation} @@ -1011,7 +1011,7 @@ public Loader<Cursor> onCreateLoader(int id, Bundle args) { <code>previousResult</code> 值是這些結果的其中一個索引，這些結果是以 <code>key</code>值擷取並加以儲存。 這樣可以讓您插入新的原始聯絡人記錄，並取得其 -{@link android.provider.BaseColumns#_ID} 值，然後在您新增 {@link android.provider.ContactsContract.Data} 列時，做為此值的「反向參考」。 +{@code android.provider.BaseColumns#_ID} 值，然後在您新增 {@link android.provider.ContactsContract.Data} 列時，做為此值的「反向參考」。 <p> 您首次呼叫 @@ -1089,7 +1089,7 @@ protected void createContactEntry() { 每項操作建立器物件會使用 {@link android.content.ContentProviderOperation.Builder#withValueBackReference(String, int) withValueBackReference()}來取得 {@link android.provider.ContactsContract.DataColumns#RAW_CONTACT_ID}。 -參照會指向第一項操作中的 {@link android.content.ContentProviderResult} 物件 (第一項操作會新增原始聯絡人列，並傳回其新的 {@link android.provider.BaseColumns#_ID} 值)。 +參照會指向第一項操作中的 {@link android.content.ContentProviderResult} 物件 (第一項操作會新增原始聯絡人列，並傳回其新的 {@code android.provider.BaseColumns#_ID} 值)。 因此，每個資料列會透過其 @@ -1229,7 +1229,7 @@ protected void createContactEntry() { 使用 {@link android.content.ContentProviderOperation#newAssertQuery(Uri)} 方法建立適合用於強制執行限制的{@link android.content.ContentProviderOperation.Builder} 物件。 如果是內容 URI，請使用 {@link android.provider.ContactsContract.RawContacts#CONTENT_URI -RawContacts.CONTENT_URI} 並附加原始聯絡人的 {@link android.provider.BaseColumns#_ID}。 +RawContacts.CONTENT_URI} 並附加原始聯絡人的 {@code android.provider.BaseColumns#_ID}。 </li> @@ -1821,8 +1821,8 @@ onPerformSync()} 方法完成。 </dl> <h2 id="SocialStream">社交串流資料</h2> <p> - {@link android.provider.ContactsContract.StreamItems} 和 -{@link android.provider.ContactsContract.StreamItemPhotos} 表格負責管理社交網路的傳入資料。 + {@code android.provider.ContactsContract.StreamItems} 和 +{@code android.provider.ContactsContract.StreamItemPhotos} 表格負責管理社交網路的傳入資料。 您可以編寫一個同步配接器，將來自您自己網路的串流資料 新增至這些表格，或是可以從這些表格讀取串流資料，然後 顯示於您自己的應用程式中，或同時具備這兩種功能。有了這些功能，您的社交網路服務和應用程式就可以整合到 Android 的社交網路體驗。 @@ -1831,7 +1831,7 @@ onPerformSync()} 方法完成。 <h3 id="StreamText">社交串流文字</h3> <p> 串流項目永遠會與原始聯絡人關聯。 -{@link android.provider.ContactsContract.StreamItemsColumns#RAW_CONTACT_ID} 會連結到原始聯絡人的 +{@code android.provider.ContactsContract.StreamItemsColumns#RAW_CONTACT_ID} 會連結到原始聯絡人的 <code>_ID</code> 值。原始聯絡人的帳戶類型和帳戶名稱也會儲存在串流項目列。 </p> @@ -1840,14 +1840,14 @@ onPerformSync()} 方法完成。 </p> <dl> <dt> - {@link android.provider.ContactsContract.StreamItemsColumns#ACCOUNT_TYPE} + {@code android.provider.ContactsContract.StreamItemsColumns#ACCOUNT_TYPE} </dt> <dd> <strong>必要。</strong>與此串流項目相關聯的原始聯絡人使用者帳戶類型。 請記得在插入串流項目時設定此值。 </dd> <dt> - {@link android.provider.ContactsContract.StreamItemsColumns#ACCOUNT_NAME} + {@code android.provider.ContactsContract.StreamItemsColumns#ACCOUNT_NAME} </dt> <dd> <strong>必要。</strong>與此串流項目相關聯的原始聯絡人使用者帳戶名稱。 @@ -1861,30 +1861,30 @@ onPerformSync()} 方法完成。 <ul> <li> - {@link android.provider.ContactsContract.StreamItemsColumns#CONTACT_ID}：與此串流項目相關聯的聯絡人 -{@link android.provider.BaseColumns#_ID} 值。 + {@code android.provider.ContactsContract.StreamItemsColumns#CONTACT_ID}：與此串流項目相關聯的聯絡人 +{@code android.provider.BaseColumns#_ID} 值。 </li> <li> - {@link android.provider.ContactsContract.StreamItemsColumns#CONTACT_LOOKUP_KEY}：與此串流項目相關聯的聯絡人 -{@link android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} 值。 + {@code android.provider.ContactsContract.StreamItemsColumns#CONTACT_LOOKUP_KEY}：與此串流項目相關聯的聯絡人 +{@code android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} 值。 </li> <li> - {@link android.provider.ContactsContract.StreamItemsColumns#RAW_CONTACT_ID}：與此串流項目相關聯的原始聯絡人 -{@link android.provider.BaseColumns#_ID} 值。 + {@code android.provider.ContactsContract.StreamItemsColumns#RAW_CONTACT_ID}：與此串流項目相關聯的原始聯絡人 +{@code android.provider.BaseColumns#_ID} 值。 </li> </ul> </dd> <dt> - {@link android.provider.ContactsContract.StreamItemsColumns#COMMENTS} + {@code android.provider.ContactsContract.StreamItemsColumns#COMMENTS} </dt> <dd> 選用。儲存您可以在串流項目開頭顯示的摘要資訊。 </dd> <dt> - {@link android.provider.ContactsContract.StreamItemsColumns#TEXT} + {@code android.provider.ContactsContract.StreamItemsColumns#TEXT} </dt> <dd> 串流項目的文字，可能是項目來源張貼的內容，或者會產生串流項目動作的描述。 @@ -1894,7 +1894,7 @@ onPerformSync()} 方法完成。 </dd> <dt> - {@link android.provider.ContactsContract.StreamItemsColumns#TIMESTAMP} + {@code android.provider.ContactsContract.StreamItemsColumns#TIMESTAMP} </dt> <dd> 內含插入或更新串流項目時間的文字字串， @@ -1905,42 +1905,42 @@ onPerformSync()} 方法完成。 </dl> <p> 如要顯示串流項目的識別資訊，請使用 -{@link android.provider.ContactsContract.StreamItemsColumns#RES_ICON}、 -{@link android.provider.ContactsContract.StreamItemsColumns#RES_LABEL} 以及 -{@link android.provider.ContactsContract.StreamItemsColumns#RES_PACKAGE} 連結到應用程式中的資源。 +{@code android.provider.ContactsContract.StreamItemsColumns#RES_ICON}、 +{@code android.provider.ContactsContract.StreamItemsColumns#RES_LABEL} 以及 +{@code android.provider.ContactsContract.StreamItemsColumns#RES_PACKAGE} 連結到應用程式中的資源。 </p> <p> - {@link android.provider.ContactsContract.StreamItems} 表格也包含 -{@link android.provider.ContactsContract.StreamItemsColumns#SYNC1} 到 -{@link android.provider.ContactsContract.StreamItemsColumns#SYNC4} 欄，專門供同步配接器使用。 + {@code android.provider.ContactsContract.StreamItems} 表格也包含 +{@code android.provider.ContactsContract.StreamItemsColumns#SYNC1} 到 +{@code android.provider.ContactsContract.StreamItemsColumns#SYNC4} 欄，專門供同步配接器使用。 </p> <h3 id="StreamPhotos">社交串流相片</h3> <p> - {@link android.provider.ContactsContract.StreamItemPhotos} 表格會儲存與串流項目相關聯的相片。 + {@code android.provider.ContactsContract.StreamItemPhotos} 表格會儲存與串流項目相關聯的相片。 表格的 -{@link android.provider.ContactsContract.StreamItemPhotosColumns#STREAM_ITEM_ID} 欄會連結到 - {@link android.provider.ContactsContract.StreamItems} 表格中 {@link android.provider.BaseColumns#_ID} 欄的值。 +{@code android.provider.ContactsContract.StreamItemPhotosColumns#STREAM_ITEM_ID} 欄會連結到 + {@code android.provider.ContactsContract.StreamItems} 表格中 {@code android.provider.BaseColumns#_ID} 欄的值。 相片參照會儲存在表格中的以下各欄： </p> <dl> <dt> - {@link android.provider.ContactsContract.StreamItemPhotos#PHOTO} 欄 (BLOB)。 + {@code android.provider.ContactsContract.StreamItemPhotos#PHOTO} 欄 (BLOB)。 </dt> <dd> 相片的二進位檔，由供應程式調整大小以進行儲存和顯示。 此欄是要提供與使用舊版聯絡人供應程式儲存相片的向下相容性。 不過，在目前版本中，您不應使用此欄來儲存相片。 -請改用 {@link android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_FILE_ID} 或 -{@link android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_URI} (下文提供這兩者的相關說明) 在檔案中儲存相片。 +請改用 {@code android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_FILE_ID} 或 +{@code android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_URI} (下文提供這兩者的相關說明) 在檔案中儲存相片。 此欄現在包含相片的縮圖可供讀取。 </dd> <dt> - {@link android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_FILE_ID} + {@code android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_FILE_ID} </dt> <dd> 原始聯絡人相片的數字識別碼。將此值附加到常數 @@ -1950,7 +1950,7 @@ openAssetFileDescriptor()} 可取得此相片檔案的控制代碼。 </dd> <dt> - {@link android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_URI} + {@code android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_URI} </dt> <dd> 直接指向此列所呈現相片的相片檔案內容 URI。 @@ -1964,27 +1964,27 @@ openAssetFileDescriptor()} 可取得相片檔案的控制代碼。 </p> <ul> <li> - 這些表格需要額外的存取權限。如要從中讀取，您的應用程式必須具備 {@link android.Manifest.permission#READ_SOCIAL_STREAM} 權限。 + 這些表格需要額外的存取權限。如要從中讀取，您的應用程式必須具備 {@code android.Manifest.permission#READ_SOCIAL_STREAM} 權限。 如要加以修改，您的應用程式必須具備 -{@link android.Manifest.permission#WRITE_SOCIAL_STREAM} 權限。 +{@code android.Manifest.permission#WRITE_SOCIAL_STREAM} 權限。 </li> <li> - 針對 {@link android.provider.ContactsContract.StreamItems} 表格，每個原始聯絡人的儲存列數是有限制的。 + 針對 {@code android.provider.ContactsContract.StreamItems} 表格，每個原始聯絡人的儲存列數是有限制的。 達到此限制後，聯絡人供應程式會自動刪除 -{@link android.provider.ContactsContract.StreamItemsColumns#TIMESTAMP} 最舊的列，為新的串流項目列騰出空間。 +{@code android.provider.ContactsContract.StreamItemsColumns#TIMESTAMP} 最舊的列，為新的串流項目列騰出空間。 如要取得此限制，請發出查詢給內容 URI -{@link android.provider.ContactsContract.StreamItems#CONTENT_LIMIT_URI}。 +{@code android.provider.ContactsContract.StreamItems#CONTENT_LIMIT_URI}。 您只要將內容 URI 設為 <code>null</code> 即可，其餘引數不需要處理。 此查詢會傳回內含單一列的 Cursor 與單一欄 -{@link android.provider.ContactsContract.StreamItems#MAX_ITEMS}。 +{@code android.provider.ContactsContract.StreamItems#MAX_ITEMS}。 </li> </ul> <p> - 類別 {@link android.provider.ContactsContract.StreamItems.StreamItemPhotos} 定義了單一串流項目，且內含相片列的 {@link android.provider.ContactsContract.StreamItemPhotos} 子表格。 + 類別 {@code android.provider.ContactsContract.StreamItems.StreamItemPhotos} 定義了單一串流項目，且內含相片列的 {@code android.provider.ContactsContract.StreamItemPhotos} 子表格。 </p> @@ -1996,8 +1996,8 @@ openAssetFileDescriptor()} 可取得相片檔案的控制代碼。 </p> <ul> <li> - 使用同步配接器將您的社交網路服務同步到聯絡人供應程式後，您可以擷取某位使用者的聯絡人最近 Activity，並將它儲存在 {@link android.provider.ContactsContract.StreamItems} 和 -{@link android.provider.ContactsContract.StreamItemPhotos} 表格中，供後續使用。 + 使用同步配接器將您的社交網路服務同步到聯絡人供應程式後，您可以擷取某位使用者的聯絡人最近 Activity，並將它儲存在 {@code android.provider.ContactsContract.StreamItems} 和 +{@code android.provider.ContactsContract.StreamItemPhotos} 表格中，供後續使用。 </li> @@ -2330,7 +2330,7 @@ Settings.UNGROUPED_VISIBLE} 欄的值設為 1。 Photo.CONTENT_ITEM_TYPE} 在列中儲存相片。 列的 {@link android.provider.ContactsContract.RawContactsColumns#CONTACT_ID} 欄是連結到其所屬原始聯絡人的 - {@link android.provider.BaseColumns#_ID} 欄。 + {@code android.provider.BaseColumns#_ID} 欄。 類別 {@link android.provider.ContactsContract.Contacts.Photo} 定義了 {@link android.provider.ContactsContract.Contacts} 的子表格，其中包含聯絡人主要相片的相片資訊，也就是聯絡人之主要原始聯絡人的主要相片。 同樣地， @@ -2343,7 +2343,7 @@ Photo.CONTENT_ITEM_TYPE} 在列中儲存相片。 {@link android.provider.ContactsContract.RawContacts.DisplayPhoto} 的參考文件含有擷取相片資訊的範例。 擷取原始聯絡人的主要縮圖沒有方便使用的類別，不過您可以傳送查詢到 {@link android.provider.ContactsContract.Data} 表格，然後選取原始聯絡人的 -{@link android.provider.BaseColumns#_ID}、{@link android.provider.ContactsContract.CommonDataKinds.Photo#CONTENT_ITEM_TYPE +{@code android.provider.BaseColumns#_ID}、{@link android.provider.ContactsContract.CommonDataKinds.Photo#CONTENT_ITEM_TYPE Photo.CONTENT_ITEM_TYPE} 以及 {@link android.provider.ContactsContract.Data#IS_PRIMARY} 欄，以尋找原始聯絡人的主要相片列。 @@ -2351,6 +2351,6 @@ Photo.CONTENT_ITEM_TYPE} 以及 {@link android.provider.ContactsContract.Data#IS </p> <p> 人員的社交串流資料可能也包括相片。這些資訊都儲存在 -{@link android.provider.ContactsContract.StreamItemPhotos} 表格。<a href="#StreamPhotos">社交串流相片</a>中針對此表格會有更詳細的說明。 +{@code android.provider.ContactsContract.StreamItemPhotos} 表格。<a href="#StreamPhotos">社交串流相片</a>中針對此表格會有更詳細的說明。 </p> |