Pengembang SYMBIAN OS V9.4 / S60v5

1. Ringkasan 

Perpustakaan Pengembang Symbian untuk Pengembang Aplikasi adalah panduan dan referensi definitif untuk semua orang yang mengembangkan perangkat lunak untuk dijalankan di OS Symbian. Apa pun peran Anda, ini adalah pemberhentian pertama untuk jawaban atas pertanyaan Anda tentang OS Symbian. Sebagai contoh :

• Jika Anda terlibat dalam merancang dan mengkodekan solusi menggunakan Symbian OS, Anda akan menemukan di sini informasi referensi lengkap tentang antarmuka umum dan API yang tersedia, materi panduan yang menjelaskan cara menggunakan berbagai fitur OS Symbian, proyek contoh, informasi teknis terperinci tentang komponen, dan jawaban atas pertanyaan yang sering diajukan (FAQ).
• Jika Anda terlibat dalam pengujian atau integrasi solusi berdasarkan OS Symbian, Anda akan menemukan informasi di sini tentang cara membangun program OS Symbian.

Anda juga dapat memengaruhi apa yang terjadi di rilis mendatang Perpustakaan OS Symbian dengan menggunakan tautan Umpan Balik yang terletak di bagian atas setiap halaman dalam kumpulan dokumen.

Jangan lupa untuk memeriksa Jaringan Pengembang Symbian untuk berita pengembang terbaru, untuk pembaruan perangkat lunak dan Perpustakaan Pengembang Symbian, dan untuk tautan ke penerima lisensi Symbian dan situs mitra.

Perhatikan bahwa Perpustakaan Pengembang Symbian tidak mendokumentasikan ekstensi penerima lisensi, termasuk platform penerima lisensi dan Antarmuka Pengguna khusus telepon. Dokumentasi untuk perpanjangan pemegang lisensi tersedia langsung dari penerima lisensi melalui program dukungan pengembang mereka.

Ketersediaan

Edisi standar Perpustakaan Pengembang Symbian didistribusikan oleh Symbian sebagai kumpulan dokumentasi HTML atau file Bantuan HTML Windows (.chm), tersedia sebagai unduhan langsung dari Jaringan Pengembang Symbian.

Mitra dan Penerima Lisensi Symbian disertakan dengan versi perpustakaan OS Symbian, yang relevan dengan kebutuhan mereka, dalam kit distribusi yang disediakan oleh Symbian.

Versi khusus dari Perpustakaan Pengembang Symbian mungkin juga tersedia di Kit Pengembangan Perangkat Lunak (SDK) yang didistribusikan oleh Penerima Lisensi.

Kompatibilitas peramban web

Perpustakaan Pengembang Symbian dirancang agar kompatibel dengan semua browser Web yang mendukung tabel dan lembar gaya, termasuk Netscape 6.01 dan yang lebih tinggi, Microsoft Internet Explorer 4.0 dan yang lebih tinggi, Opera 5.0 dan yang lebih tinggi.

2. Menemukan jalan keluar Anda

Perpustakaan Pengembang Symbian adalah kumpulan dokumentasi besar. Untuk membantu Anda menemukan apa yang Anda butuhkan, halaman ini memberikan pengantar isinya. Tidak semua bagian dari dokumentasi relevan untuk semua jenis pengguna OS, jadi pengantar ini dibagi menjadi beberapa kelompok sebagai berikut :

• Struktur OS dan API menjelaskan bagian yang memberikan deskripsi inti sistem operasi dan cara bekerja dengannya, termasuk referensi OS Symbian dan panduan OS Symbian .
• Pendatang baru di Symbian OS menjelaskan bagian yang menyediakan pengenalan Symbian OS bagi mereka yang bekerja dengannya untuk pertama kalinya
• Pemeliharaan dan peningkatan menjelaskan bagian yang ditujukan untuk mereka yang berpindah di antara rilis OS Symbian

Struktur OS dan API

Informasi inti tentang layanan yang ditawarkan Symbian OS, dan cara menggunakannya, terdapat dalam tiga bagian :

• Referensi OS Symbian menyediakan deskripsi item demi item dari kelas dan tipe lain yang membentuk API
• Panduan Symbian OS menjelaskan arsitektur dan fungsionalitas OS, dan menyediakan panduan tentang penggunaan API mereka
• Alat dan Utilitas OS Symbian menjelaskan alat untuk mengembangkan dan membangun program

Untuk mempermudah pengembangan, bagian selanjutnya memberikan informasi tambahan :

• Contoh menjelaskan contoh program yang menggambarkan cara menggunakan API
• FAQ Knowledgebase memberikan jawaban atas pertanyaan pengembang yang sering diajukan, bersama dengan tips berguna lainnya
• Daftar Istilah OS Symbian mendefinisikan istilah dan konsep utama

Symbian OS adalah sistem besar, berisi ratusan kelas dan ribuan fungsi anggota. Seperti kebanyakan sistem yang kompleks, paling mudah untuk didekati dengan membaginya menjadi area yang luas, dan secara bertahap mempersempit fokus Anda ke area yang paling penting untuk tugas Anda. Panduan OS Symbian ini dan referensi OS Symbian menggunakan divisi besar yang disebut subsistem. Misalnya, subsistem Mesin Aplikasi berisi semua API yang dapat digunakan untuk memanipulasi data untuk aplikasi standar seperti Kontak. Subsistem pada gilirannya terdiri dari komponen yang menyediakan perpustakaan dan file header yang dapat digunakan program. Salah satu cara untuk menjelajahi OS adalah dengan terlebih dahulu mengenal subsistem , lalu menelusuri komponennya.

Atau, jika Anda mengetahui nama API yang Anda minati, cara termudah untuk membuka halaman referensinya adalah dengan menggunakan tab Indeks dalam versi Bantuan HTML dari dokumentasi, yang mencantumkan semua API menurut abjad. Atau, klik Indeks di bilah judul halaman mana pun untuk membuka daftar API yang dibagi ke dalam kategori, seperti kelas, fungsi, dan konstanta. Lihat Menggunakan indeks untuk informasi lebih lanjut.

Bagian berikut menjelaskan panduan, referensi, dan bagian lain secara lebih rinci.

Referensi OS Symbian

Referensi berisi tiga bagian :

• Referensi komponen C++ menjelaskan tipe C++ yang menyediakan layanan sistem operasi untuk program. Ini dijelaskan secara lebih rinci di bawah ini.
• Referensi sumber daya : Symbian OS mendefinisikan bahasa sumber dayanya sendiri yang digunakan untuk mendefinisikan struktur antarmuka pengguna, teks yang dapat dilokalkan, dan data statis lainnya. Beberapa bagian dari OS memberikan definisi sumber daya yang dapat digunakan oleh program lain. Ini dijelaskan di bagian referensi ini.
• Referensi kepanikan sistem mendokumentasikan kepanikan yang dapat dihasilkan oleh komponen sistem. Panik adalah kode kesalahan yang dimunculkan oleh komponen sebagai respons terhadap kesalahan pemrograman, seperti melewatkan nilai parameter ilegal. Bagian referensi ini menjelaskan arti dari kode kesalahan ini.

Referensi komponen C++ mencantumkan komponen sistem operasi, dikelompokkan bersama berdasarkan subsistem. Dalam setiap bagian, halaman referensi untuk setiap item API disediakan, diatur menurut abjad. Berikut ini menunjukkan awal halaman referensi khas, dalam hal ini untuk kelas RDir.

Seperti yang Anda lihat, halaman referensi untuk RDird ibagi menjadi beberapa bagian:

1. Lokasi : file header, terletak di epoc32\include direktori kit, yang mendeklarasikan kelas. Proyek Anda harus menyertakan tajuk ini untuk menggunakan kelas.
2. Tautan terhadap : perpustakaan yang berisi kelas. Proyek Anda harus menautkan ke perpustakaan ini untuk menggunakan kelas.
3. Description : menjelaskan tujuan dan kegunaan class
4. Derivasi : memberi nama dan menjelaskan secara singkat setiap kelas dasar untuk kelas tersebut
5. Anggota : daftar abjad anggota kelas. Anggota yang dideklarasikan di kelas itu sendiri diberikan terlebih dahulu, lalu anggota yang disediakan oleh kelas dasar apa pun.

Halaman referensi kemudian menjelaskan setiap anggota kelas secara bergantian. Anggota dikelompokkan menjadi beberapa bagian berikut :

• Konstruksi dan penghancuran: bagian ini menjelaskan konstruktor kelas, fungsi pabrik, dan destruktor.
• Fungsi anggota
• Kelas dan struct anggota
• enumerasi anggota
• Definisi tipe anggota
• data anggota

Halaman referensi hanya menampilkan API yang dimaksudkan untuk digunakan, jadi, misalnya, anggota data pribadi dan fungsi internal yang tidak diekspor oleh pustaka tidak ditampilkan.

Dalam kebanyakan kasus, API stabil dan dimaksudkan untuk digunakan di ponsel yang dirilis. Namun, jika tidak demikian, dokumentasi menyediakan informasi status antarmuka . Ini adalah salah satu kategori berikut :

Ada satu jenis informasi khusus OS Symbian lainnya yang akan Anda lihat di halaman referensi, yaitu informasi kemampuan keamanan platform. Untuk melindungi perangkat dari program jahat, beberapa fungsi sistem yang sensitif memerlukan program pemanggil untuk memiliki izin, yang dinyatakan sebagai pengaturan kemampuan, untuk menggunakannya. Dokumentasi untuk fungsi tersebut memiliki bagian Kemampuan yang memberi tahu Anda apa yang diperlukan. Sebagai contoh:

Kemampuan: Drm

menunjukkan bahwa program pemanggil harus memiliki kemampuan yang disebut Drm. Untuk informasi selengkapnya, lihat bagian Keamanan platform .

Kemampuan untuk beberapa fungsi bergantung pada nilai argumen yang diteruskan ke fungsi tersebut. Jika hal ini terjadi, kapabilitas digambarkan sebagai Dependent , dan biasanya diikuti dengan deskripsi kondisi.

Kemampuan untuk beberapa fungsi bergantung pada nilai argumen yang diteruskan ke fungsi tersebut. Jika hal ini terjadi, kapabilitas digambarkan sebagai Dependent , dan biasanya diikuti dengan deskripsi kondisi.

Panduan OS Symbian

Panduan Symbian OS menyediakan dokumen pengantar ke sistem secara keseluruhan, diikuti oleh panduan subsistem demi subsistem untuk komponen di OS.

Dokumentasi untuk subsistem berisi panduan cara kerja, yang memiliki judul dalam bentuk "Menggunakan nama-komponen". Panduan ini biasanya memberikan gambaran singkat tentang kelas-kelas di API yang ditawarkan komponen, dan menunjukkan cara-cara utama untuk menggunakan kelas-kelas ini.

Alat dan Utilitas OS Symbian

Pengembangan perangkat lunak Symbian OS mengharuskan Anda untuk terbiasa dengan sejumlah alat dan praktik pengembangan. Proses pengembangan C++ memberikan panduan cepat tentang hal-hal penting, mulai dari mendefinisikan proyek perangkat lunak, hingga bekerja dengan emulator untuk mengembangkan, men-debug, dan menguji perangkat lunak pada PC Windows, hingga langkah terakhir membangun dan menerapkan pada perangkat keras target.

Alat dan Utilitas OS Symbian memberikan detail lengkap tentang alat OS Symbian. Untuk banyak bagian yang paling sering digunakan adalah panduan alat Build dan referensi alat Build , yang menjelaskan file proyek yang diperlukan untuk pemrograman Symbian OS, dan cara membangun untuk berbagai target asli dan yang diemulasi. Ini juga menjelaskan alat lain yang mendukung pengembangan Anda, termasuk format dan kompiler file sumber daya, file bitmap, file paket instalasi, dan file bantuan.

FAQ Basis Pengetahuan

FAQ Knowledgebase berisi jawaban yang ditulis oleh pengembang Symbian dan kelompok pendukung mitra untuk pertanyaan dan masalah umum. FAQ Knowledgebase juga tersedia di Jaringan Pengembang Symbian .

FAQ terdaftar dalam urutan tanggal dari terbaru ke terlama. Perhatikan bahwa FAQ yang lebih lama mungkin tidak berlaku untuk versi OS saat ini. Anda dapat melihat untuk versi OS apa FAQ dibuat dari sub-judul Platform -nya.

Contoh

Bagian Contoh memberikan instruksi untuk membangun dan menggunakan kumpulan besar contoh C++ yang menyertai Perpustakaan Pengembang Symbian. Proyek termasuk contoh yang menunjukkan penggunaan kelas dasar OS Symbian, teknik dan idiom penting yang dapat digunakan dalam mengembangkan aplikasi OS Symbian, dan banyak contoh yang menunjukkan cara menggunakan API C++ Symbian OS tertentu.

Perhatikan bahwa dalam versi khusus dari Perpustakaan Pengembang Symbian penerima lisensi, contoh umum OS Symbian dapat diganti dengan contoh khusus telepon.

Kode contoh disediakan untuk tujuan ilustrasi dan demonstrasi, dan tidak boleh dianggap dapat digunakan sebagai kode produk.

Pendatang baru di Symbian OS

Ada beberapa bagian yang ditujukan untuk mereka yang baru pertama kali mengembangkan OS Symbian.

Tutorial Pengembangan Aplikasi adalah panduan pengetahuan utama yang Anda perlukan untuk memulai pengembangan. Ini menggunakan program contoh berfitur lengkap pada platform UIQ.

Dalam panduan OS Symbian, topik yang berguna adalah idiom Esensial , yang menjelaskan idiom dan konvensi pemrograman khusus untuk OS Symbian, dan Tentang pengembangan OS Symbian , yang menjelaskan lingkungan pengembangan OS Symbian dan siklus hidup pengembangan.

Pemeliharaan dan peningkatan

Perpustakaan Pengembang Symbian menyediakan dua sumber daya yang berguna untuk pengembang berpengalaman yang ingin mengetahui apa yang berubah di OS, untuk mempertahankan atau memperluas program yang ada.

Bagian Apa yang baru menjelaskan perubahan dalam kumpulan dokumentasi sejak rilis terakhir. Perubahan dokumentasi referensi item API mencantumkan API yang ditambahkan, dihapus, dan diubah.

3. Konvensi dokumentasi

Ringkasan

Topik ini menjelaskan desain dan konvensi tipografi yang digunakan dalam edisi Perpustakaan Pengembang Symbian ini.

Gaya

Berbagai gaya tipografi digunakan di seluruh Perpustakaan Pengembang Symbian. Beberapa gaya digunakan untuk membuat teks lebih mudah dipahami, misalnya untuk menyorot fragmen kode, input pengguna yang dituju, nama file literal, atau teks kutipan lainnya; gaya lain digunakan untuk menandai pembatasan dan penerapan umum teks. Gaya tautan juga digunakan untuk navigasi hypertext. Perhatikan bahwa dokumentasi referensi menggunakan rentang terbatas gaya yang tersedia.

notasi UML

Diagram UML digunakan untuk menggambarkan hubungan antara kelas dan/atau objek. Sebagian besar kelas dalam diagram ini tertaut ke bagian terkait di Referensi API. Notasi UML berikut digunakan :

tata bahasa BNF

Tata bahasa Backus-Naur Form (BNF) digunakan sebagai alat untuk mendeskripsikan bahasa dan sintaks perintah, misalnya:

select-statement: SELECT select-list FROM table-name[ restriction] [ ordering]

restriction:WHERE search-condition

ordering:ORDER BY sort-order

Definisi BNF menyatakan bahwa item bernama yang diberikan sebelum titik dua ditulis seperti yang dijelaskan setelah titik dua. Misalnya, sebuah pengurutan ditulis sebagai ORDER BY diikuti oleh pengurutan (yang dapat didefinisikan di tempat lain).

4. Menggunakan indeks

Indeks pohon dokumen

Halaman Pohon Dokumen Lengkap menunjukkan struktur kumpulan dokumen lengkap dan menempatkan setiap dokumen di dalamnya. Gunakan indeks ini untuk mengidentifikasi konten topik lengkap secara sekilas dan untuk menavigasi langsung ke dokumen yang menarik, dan secara umum untuk menemukan jalan di sekitar struktur dokumentasi.

Indeks Angka melengkapi ini dengan daftar diagram dan tangkapan layar.

C++ indeks abjad

Ada delapan indeks alfabet terpisah yang menyediakan navigasi langsung ke item C++ API yang dijelaskan dalam dokumentasi referensi. Ini diatur sebagai berikut :

• Indeks datar mencantumkan semua jenis di OS
• Hirarki kelas menunjukkan hierarki pewarisan untuk kelas
• Fungsi anggota
• Enumerasi mencantumkan semua enumerasi, baik yang didefinisikan di dalam atau di luar ruang lingkup kelas
• Konstanta dan bendera mencantumkan nilai yang disebutkan
• Fungsi non-anggota
• Typedef
• Makro praprosesor