Data dan State

BAB 9: Fitur Native

Kamera, lokasi, penyimpanan terenkripsi, dan notifikasi: cara meminta izin, menangani penolakan, dan menghindari kesalahan yang membuat fitur berhenti bekerja diam-diam.

4 kemampuan berikut membedakan aplikasi mobile dari aplikasi web: mengambil foto, membaca lokasi, menyimpan rahasia dengan aman, dan mengirim notifikasi. Semuanya bergantung pada izin sistem, dan semuanya punya cara gagal yang tidak selalu terlihat sebagai error.

Bab ini membahas keempatnya dengan pola yang sama: periksa izin, minta bila perlu, tangani penolakan, baru jalankan fitur.

Kamera

BashBASH
npx expo install expo-camera

Izin kamera diperiksa lewat hook, dan hook itu memberi 3 hal: status, fungsi untuk meminta, dan fungsi untuk membaca ulang.

React TSXTSX
import { CameraView, useCameraPermissions } from "expo-camera";
import { useRef, useState } from "react";
import { Pressable, Text, View } from "react-native";

export default function LayarKamera() {
  const [izin, mintaIzin] = useCameraPermissions();
  const [siap, setSiap] = useState(false);
  const kamera = useRef<CameraView>(null);

  if (!izin) return <View />;

  if (!izin.granted) {
    return (
      <View style={{ flex: 1, justifyContent: "center", padding: 24, gap: 12 }}>
        <Text style={{ fontWeight: "700" }}>Akses kamera diperlukan</Text>
        <Text style={{ color: "#64748b" }}>
          Kamera dipakai untuk memotret bukti pengiriman. Izin bisa diberikan sekarang.
        </Text>
        <Pressable onPress={mintaIzin}>
          <Text style={{ color: "#6366f1", fontWeight: "600" }}>
            {izin.canAskAgain ? "Izinkan kamera" : "Buka pengaturan"}
          </Text>
        </Pressable>
      </View>
    );
  }

  const potret = async () => {
    if (!siap) return;
    const hasil = await kamera.current?.takePictureAsync({ quality: 0.7 });
    return hasil?.uri;
  };

  return (
    <View style={{ flex: 1 }}>
      <CameraView ref={kamera} style={{ flex: 1 }} facing="back" onCameraReady={() => setSiap(true)} />
      <Pressable
        onPress={potret}
        disabled={!siap}
        style={{ position: "absolute", bottom: 32, alignSelf: "center", backgroundColor: "#6366f1", paddingHorizontal: 24, paddingVertical: 14, borderRadius: 999, opacity: siap ? 1 : 0.5 }}
      >
        <Text style={{ color: "#fff", fontWeight: "700" }}>Ambil foto</Text>
      </Pressable>
    </View>
  );
}

3 hal yang sering terlewat:

Tunggu onCameraReady. Memanggil takePictureAsync sebelum kamera siap menghasilkan error di Android.

Hasil foto bersifat sementara. Berkas disimpan di cache aplikasi dan bisa dibersihkan sistem. Kalau foto harus bertahan, salin ke folder dokumen:

TypeScriptTS
import * as FileSystem from "expo-file-system";
import { randomUUID } from "expo-crypto";

async function simpanPermanen(uriSementara: string) {
  const tujuan = `${FileSystem.documentDirectory}foto/${randomUUID()}.jpg`;
  await FileSystem.makeDirectoryAsync(`${FileSystem.documentDirectory}foto/`, { intermediates: true });
  await FileSystem.copyAsync({ from: uriSementara, to: tujuan });
  return tujuan;
}

Jangan minta izin saat aplikasi dibuka. Minta ketika pengguna menekan tombol kamera, dengan alasan yang jelas di layar. Permintaan izin tanpa konteks adalah penyebab utama penolakan.

Lokasi

BashBASH
npx expo install expo-location
TypeScriptTS
import * as Location from "expo-location";

export async function ambilLokasiSekali() {
  const izin = await Location.requestForegroundPermissionsAsync();

  if (!izin.granted) {
    return { status: "ditolak" as const, bisaTanyaLagi: izin.canAskAgain };
  }

  const posisi = await Location.getCurrentPositionAsync({
    accuracy: Location.Accuracy.Balanced,
  });

  return {
    status: "ok" as const,
    lintang: posisi.coords.latitude,
    bujur: posisi.coords.longitude,
    akurasiMeter: posisi.coords.accuracy ?? null,
  };
}

Untuk memantau pergerakan, gunakan langganan yang harus dilepas saat layar ditutup:

TypeScriptTS
const langganan = await Location.watchPositionAsync(
  { accuracy: Location.Accuracy.High, distanceInterval: 10, timeInterval: 5000 },
  (posisi) => {
    // kirim atau simpan posisi
  },
);

// saat layar dilepas
langganan.remove();

Pilihan akurasi memengaruhi konsumsi baterai. Balanced cukup untuk menampilkan kota, High dipakai untuk navigasi atau pencatatan jarak. Meminta Highest untuk kebutuhan yang tidak menuntut presisi akan menguras baterai dan memperlambat respons.

Lokasi latar belakang memerlukan izin tambahan dan penjelasan di kebijakan privasi. Banyak aplikasi tidak membutuhkannya, dan menambahkannya tanpa alasan yang kuat menyulitkan proses tinjauan toko aplikasi.

Penyimpanan terenkripsi

AsyncStorage menyimpan teks apa adanya. Untuk token, kunci API pengguna, atau data pribadi, gunakan SecureStore yang memakai Keychain di iOS dan Keystore di Android.

BashBASH
npx expo install expo-secure-store
TypeScriptTS
import * as SecureStore from "expo-secure-store";

const KUNCI_TOKEN = "sesi.token";

export async function simpanToken(token: string) {
  await SecureStore.setItemAsync(KUNCI_TOKEN, token, {
    keychainAccessible: SecureStore.WHEN_UNLOCKED_THIS_DEVICE_ONLY,
  });
}

export async function bacaToken() {
  return SecureStore.getItemAsync(KUNCI_TOKEN);
}

export async function hapusToken() {
  await SecureStore.deleteItemAsync(KUNCI_TOKEN);
}

Beberapa aturan yang perlu diketahui:

Nama kunci hanya boleh berisi huruf, angka, titik, tanda hubung, dan garis bawah. Karakter lain menyebabkan pemanggilan gagal.

Nilai yang disimpan harus berupa string, dan ukurannya terbatas. Jangan menyimpan gambar atau berkas besar di sini.

Opsi requireAuthentication bisa meminta biometrik sebelum nilai dibaca. Konsekuensinya, pembacaan bisa gagal bukan karena data rusak, tapi karena pengguna membatalkan dialog, belum mendaftarkan sidik jari, atau perangkat terkunci. Kode harus membedakan 2 hal itu:

TypeScriptTS
try {
  const token = await SecureStore.getItemAsync(KUNCI_TOKEN, { requireAuthentication: true });
  if (!token) return { status: "kosong" as const };
  return { status: "ok" as const, token };
} catch (galat) {
  const pesan = galat instanceof Error ? galat.message : "";
  const dibatalkan = /cancel/i.test(pesan);
  return { status: dibatalkan ? ("dibatalkan" as const) : ("gagal" as const) };
}

Satu hal yang mudah menjebak: nilai dengan requireAuthentication akan tidak bisa dibaca lagi ketika data biometrik berubah, misalnya pengguna menambah sidik jari baru. Untuk token sesi, itu berarti pengguna harus masuk ulang, dan aplikasi harus menanganinya sebagai keadaan normal, bukan sebagai kerusakan.

Notifikasi

BashBASH
npx expo install expo-notifications

Penanganan notifikasi punya 2 bagian: izin, dan perilaku saat notifikasi diterima ketika aplikasi sedang terbuka.

TypeScriptTS
import * as Notifications from "expo-notifications";

Notifications.setNotificationHandler({
  handleNotification: async () => ({
    shouldShowBanner: true,
    shouldShowList: true,
    shouldPlaySound: false,
    shouldSetBadge: true,
  }),
});

export async function siapkanNotifikasi() {
  const izin = await Notifications.getPermissionsAsync();
  if (izin.granted) return true;

  const diminta = await Notifications.requestPermissionsAsync();
  return diminta.granted;
}

export async function kirimPengingatLokal(judul: string, isi: string) {
  await Notifications.scheduleNotificationAsync({
    content: { title: judul, body: isi, sound: false },
    trigger: null,
  });
}

trigger: null berarti tampilkan sekarang. Untuk pengingat terjadwal, trigger diisi waktu atau interval, dan bentuknya berbeda antara Android dan iOS. Uji keduanya di perangkat nyata, karena emulator tidak selalu mereproduksi perilaku notifikasi.

3 catatan operasional:

Notifikasi tidak muncul di emulator tanpa konfigurasi tambahan, dan tidak muncul sama sekali di perangkat Android yang menghentikan paksa aplikasi.

Untuk notifikasi push dari server, dibutuhkan token perangkat yang diambil lewat getExpoPushTokenAsync atau token APNs dan FCM. Pengiriman push tidak bisa diuji hanya dengan build lokal.

Badge angka perlu dibersihkan secara eksplisit ketika pengguna membaca notifikasi, kalau tidak angkanya menumpuk.

Izin lintas platform

KemampuanAndroidiOS
Kameraizin runtime, dialog sistemNSCameraUsageDescription wajib saat build
Lokasi depanizin runtime, pilihan presisiNSLocationWhenInUseUsageDescription
Lokasi latarizin terpisah, sering ditinjau manualNSLocationAlwaysAndWhenInUseUsageDescription
Notifikasiizin runtime sejak Android 13izin runtime
Biometrikizin USE_BIOMETRICNSFaceIDUsageDescription

Teks alasan izin di iOS dibaca pengguna dan ditinjau App Store. Kalimat seperti "aplikasi membutuhkan akses kamera" sering ditolak karena tidak menjelaskan manfaat. Tulis tujuan konkret: "Kamera dipakai untuk memotret bukti pengiriman."

Kesalahan yang sering terjadi

GejalaPenyebabPerbaikan
kamera hitam di AndroidtakePictureAsync dipanggil sebelum siappanggil setelah onCameraReady
foto hilang setelah beberapa haridisimpan di cachesalin ke folder dokumen
lokasi selalu nolizin ditolak atau GPS belum terkunciperiksa granted, coba getLastKnownPositionAsync
token hilang setelah pengguna menambah sidik jarikunci SecureStore divalidasi biometriktangani sebagai keadaan perlu masuk ulang
notifikasi tidak munculizin ditolak atau aplikasi dihentikan paksaperiksa status izin, uji di perangkat
baterai cepat habispemantauan lokasi berakurasi tinggiturunkan akurasi atau interval

Latihan singkat

  1. Tambahkan tombol kamera yang menyimpan foto ke folder dokumen, lalu pastikan berkas masih ada setelah aplikasi ditutup sepenuhnya.
  2. Simpan token contoh di SecureStore, hapus aplikasi, pasang ulang, dan periksa apakah nilainya masih ada. Catat perbedaan perilaku Android dan iOS.
  3. Buat pengingat lokal 5 detik setelah tombol ditekan, dan uji dengan aplikasi di latar belakang serta dalam keadaan tertutup.

Ringkasan

Fitur native selalu dimulai dari izin, dan izin harus diminta saat dibutuhkan dengan alasan yang bisa dibaca pengguna. Kamera menunggu onCameraReady dan hasilnya harus disalin bila perlu bertahan. Lokasi memilih akurasi sesuai kebutuhan, bukan setinggi mungkin. SecureStore menyimpan rahasia, dengan konsekuensi biometrik yang harus ditangani sebagai keadaan, bukan error. Notifikasi memerlukan izin, penanganan saat aplikasi terbuka, dan pengujian di perangkat nyata.

Bab 10 membahas cara memastikan semua ini tetap bekerja setelah kode berubah: pengujian, debugging, dan membaca laporan kesalahan dari perangkat pengguna.