Mempersiapkan Bilah Aplikasi

Dalam bentuk yang paling dasar, bilah aksi menampilkan judul untuk aktivitas di satu sisi dan menu luapan di sisi yang lain. Bahkan dalam bentuk sederhana ini, bilah aplikasi memberikan informasi yang berguna bagi pengguna, dan membantu memberikan tampilan dan kesan yang konsisten untuk aplikasi Android.

Gambar 1. Sebuah bilah aplikasi dengan judul aplikasi dan menu luapan.

Mulai Android 3.0 (API level 11), seluruh aktivitas yang menggunakan tema default memiliki ActionBar sebagai bilah aplikasi. Akan tetapi, fitur bilah aplikasi secara bertahap telah ditambahkan ke ActionBar asli melalui beragam rilis Android. Sebagai hasilnya, ActionBar asli berperilaku berbeda bergantung pada versi sistem Android yang digunakan perangkat. Sebaliknya, fitur terbaru ditambahkan ke pustaka dukungan versi Toolbar, dan mereka tersedia pada setiap perangkat yang bisa menggunakan pustaka dukungan.

Dengan alasan ini, Anda harus menggunakan pustaka dukungan kelas Toolbar untuk mengimplementasikan aktivitas bilah aplikasi Anda. Menggunakan bilah alat pustaka dukungan membantu memastikan bahwa aplikasi Anda akan memiliki perilaku yang konsisten pada seluruh jangkauan terluas dari perangkat. Misalnya, widget Toolbar memberikan pengalaman desain material pada perangkat yang menjalankan Android 2.1 (API level 7) atau yang lebih baru, namun bilah aksi asli tidak mendukung desain material kecuali jika perangkat tersebut menjalankan Android 5.0 (API level 21) atau yang lebih baru.

Menambahkan Bilah Alat ke sebuah Aktivitas

Langkah-langkah ini menjelaskan cara mempersiapkan Toolbar sebagai bilah aplikasi aktivitas Anda:
  1. Tambahkan pustaka dukungan appcompat v7 ke proyek Anda, seperti yang dijelaskan dalam Persiapan Pustaka Dukungan.
  2. Pastikan aktivitas mencakup AppCompatActivity:
    public class MyActivity extends AppCompatActivity {
      // ...
    }
    

    Catatan: Buat perubahan ini untuk setiap aktivitas dalam aplikasi Anda yang menggunakan Toolbar sebagai bilah aplikasi.

  3. Dalam manifes aplikasi, atur elemen <application> untuk menggunakan salah satu tema NoActionBar appcompat. Menggunakan salah satu tema ini mencegah aplikasi menggunakan kelas ActionBar asli untuk menyediakan bilah aplikasi. Misalnya:
    <application
        android:theme="@style/Theme.AppCompat.Light.NoActionBar"
        />
    
  4. Tambahkan Toolbar ke layout aktivitas. Misalnya, kode layout berikut menambahkan Toolbar dan memberikan penampilan yang mengambang di atas aktivitas:
    <android.support.v7.widget.Toolbar
       android:id="@+id/my_toolbar"
       android:layout_width="match_parent"
       android:layout_height="?attr/actionBarSize"
       android:background="?attr/colorPrimary"
       android:elevation="4dp"
       android:theme="@style/ThemeOverlay.AppCompat.ActionBar"
       app:popupTheme="@style/ThemeOverlay.AppCompat.Light"/>
    

    Spesifikasi Desain Material menyarankan agar bilah aplikasi memiliki elevasi 4 dp.

    Letakkan bilah alat di bagian atas layout aktivitas ini, karena Anda menggunakannya sebagai bilah aplikasi.

  5. Dalam metode onCreate() aktivitas, panggil metode setSupportActionBar() aktivitas, dan teruskan bilah alat aktivitas ini. Metode ini menetapkan bilah alat sebagai bilah aplikasi untuk aktivitas tersebut. Misalnya:
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_my);
        Toolbar myToolbar = (Toolbar) findViewById(R.id.my_toolbar);
        setSupportActionBar(myToolbar);
        }
    

Aplikasi Anda sekarang memiliki bilah aksi dasar. Secara default, bilah aksi hanya berisi nama aplikasi dan menu luapan. Menu opsi pada mulanya hanya berisi item Settings. Anda bisa menambahkan lebih banyak tindakan ke bilah aksi dan menu luapan, seperti yang dijelaskan dalam Menambahkan dan Menangani Tindakan.

Menggunakan Metode Utilitas Bilah Aplikasi

Setelah Anda menyetel bilah alat sebagai bilah aplikasi aktivitas ini, Anda memiliki akses ke beragam metode utilitas yang disediakan oleh kelas ActionBar dari pustaka dukungan appcompat v7. Pendekatan ini memungkinkan Anda melakukan beberapa hal yang berguna, seperti menyembunyikan dan menunjukkan bilah aplikasi.

Untuk menggunakan metode utilitas ActionBar, panggil metode getSupportActionBar() aktivitas. Metode ini mengembalikan referensi ke objek ActionBar appcompat. Setelah Anda memiliki referensi tersebut, Anda bisa memanggil metode ActionBar untuk menyesuaikan bilah aplikasi. Misalnya, untuk menyembunyikan bilah aplikasi, panggil ActionBar.hide().