Variabel Lingkungan: Apa Itu, Penggunaan dan Konfigurasi dalam Proyek Mobile

Apa itu variabel lingkungan

Variabel lingkungan adalah pasangan kunci-nilai, yang dapat diakses oleh proses aplikasi melalui API sistem operasi. Mereka diteruskan ke proses saat pembuatannya dan hanya ada selama proses tersebut berjalan. Tidak seperti parameter konfigurasi yang tertanam dalam kode sumber, variabel lingkungan tidak memerlukan kompilasi ulang untuk mengubah nilai. Ini adalah prinsip fundamental Twelve-Factor App yang memastikan pemisahan yang jelas antara kode dan konfigurasi.

Dalam pengembangan mobile, variabel lingkungan memecahkan masalah konfigurasi yang berbeda untuk berbagai lingkungan: pengembang menggunakan server lokal, penguji menggunakan staging, pengguna menggunakan produksi. Alih-alih menyimpan tiga URL backend dalam kode dengan operator kondisional if-else, pengembang meneruskan satu URL melalui variabel lingkungan pada tahap build. Ini menyederhanakan kode dan menghilangkan risiko penggunaan server produksi secara tidak sengaja di lingkungan pengujian.

Keuntungan utama adalah keamanan: data sensitif tidak masuk ke repositori kode. Kunci API, rahasia Firebase, token akses backend, dan sertifikat dimuat melalui CI/CD langsung ke lingkungan build. Jika penyerang mendapatkan akses ke repositori kode, dia tidak akan menemukan rahasia di sana, karena rahasia tersebut disimpan di penyimpanan terlindungi sistem CI dan hanya diteruskan pada tahap build file biner.

Mengapa variabel lingkungan diperlukan dalam pengembangan mobile

Proyek mobile memiliki setidaknya tiga lingkungan: development, staging, dan produksi. Setiap lingkungan membutuhkan konfigurasi sendiri: URL server, nama paket, skema penandatanganan, dan sertifikat notifikasi push. Tanpa variabel lingkungan, pengembang harus mengubah konfigurasi secara manual sebelum setiap build, yang menyebabkan kesalahan: kunci produksi yang terlupakan dalam build pengujian dapat menyebabkan pengiriman notifikasi ke pengguna nyata atau konsumsi API berbayar.

Pemisahan lingkungan

Variabel lingkungan memungkinkan pergantian backend tanpa mengubah kode: cukup mengganti nilai dalam variabel API_BASE_URL. Flag fungsionalitas (feature flags) dikelola melalui variabel seperti FEATURE_CHAT_ENABLED=true, yang memungkinkan mengaktifkan fitur baru di staging tanpa memengaruhi produksi. Untuk setiap lingkungan, file .env sendiri dibuat yang dimuat pada tahap build.

class AppConfig {
  static final String apiBaseUrl =
    const String.fromEnvironment('API_BASE_URL',
      defaultValue: 'http://localhost:8080');
}

Keamanan kunci

Kunci yang dikodekan secara keras adalah kerentanan umum pada aplikasi mobile. Penyerang mendekompilasi APK atau IPA menggunakan alat seperti jadx atau Hopper dan mengekstrak rahasia dari file biner. Bahkan obfuskasi pun tidak melindungi literal string — mereka mudah ditemukan dalam kode setelah dekompilasi. Variabel lingkungan memecahkan masalah ini dengan meneruskan kunci pada tahap build melalui CI/CD, di mana kunci tersebut ditutupi dalam log.

object Config {
    val apiKey: String =
        System.getenv("API_KEY") ?: throw
            IllegalStateException("API_KEY not set")
}

Integrasi CI/CD

Variabel lingkungan terintegrasi dengan pipeline build: GitHub Actions, GitLab CI, Bitrise, dan CircleCI mendukung variabel rahasia yang tidak ditampilkan dalam log. Pada tahap build, CI menyisipkan nilai yang sesuai tergantung pada cabang atau tag: untuk cabang develop digunakan staging, untuk tag v* digunakan produksi. Ini mengotomatiskan proses dan menghilangkan faktor manusia, memastikan setiap build menerima set konfigurasi yang benar.

File .env dan pustaka manajemen

File .env adalah cara standar untuk menyimpan variabel lingkungan dalam format KEY=VALUE. File ini tidak disertakan dalam repositori, sebaliknya .env.example dengan template semua variabel dan nilai kosong ditambahkan ke repositori. Setiap pengembang membuat file .env sendiri dengan pengaturan lokal, tanpa memengaruhi konfigurasi anggota tim lainnya. Untuk lingkungan yang berbeda, file terpisah digunakan: .env.dev, .env.stage, .env.prod.

# .env.example — template untuk pengembang
API_BASE_URL=http://localhost:8080
FEATURE_CHAT_ENABLED=true
SENTRY_DSN=

Untuk proyek mobile, ada pustaka khusus untuk bekerja dengan file .env:

• flutter_dotenv (Flutter) — memuat variabel dari .env saat runtime melalui dotenv.load()
• BuildConfig (Android) — menghasilkan bidang bertipe dari nilai build.gradle
• xcconfig (iOS) — menghubungkan file konfigurasi ke skema build Xcode yang berbeda
• react-native-config (React Native) — manajemen variabel melalui file .env

Pengaturan cabang di CI/CD memungkinkan penyisipan file .env yang berbeda: .env.dev untuk server pengujian, .env.stage untuk pra-rilis, dan .env.prod untuk publikasi di toko aplikasi. File dengan rahasia dimuat dari penyimpanan aman (Vault, AWS Secrets Manager) dan tidak disimpan di repositori. Ini memastikan bahwa bahkan jika sistem kontrol versi dikompromikan, rahasia tetap terlindungi.

Variabel lingkungan dalam proyek iOS

EkOS iOS menggunakan file xcconfig untuk mengelola variabel di tingkat build. Mereka terhubung ke skema Xcode dan memungkinkan penimpaan nilai untuk konfigurasi Debug dan Release. File xcconfig mendukung pewarisan: file dasar dengan pengaturan umum dan file khusus untuk setiap lingkungan dapat dibuat.

Konfigurasi file xcconfig

File xcconfig menyimpan variabel dalam format KEY = VALUE dan terhubung ke skema build di Xcode melalui pengaturan Configuration. Variabel dari xcconfig dapat diakses di Info.plist melalui sintaks $(VARIABLE_NAME), yang memungkinkan penggunaan pengidentifikasi bundel dan nama aplikasi yang berbeda untuk skema yang berbeda. Untuk identifikasi lingkungan yang cepat, sufiks Dev atau Staging ditambahkan ke nama aplikasi.

# Config/Dev.xcconfig — konfigurasi pengembangan
API_BASE_URL = http://localhost:3000
BUNDLE_ID_SUFFIX = .dev
APP_DISPLAY_NAME = MyApp Dev

Kode Swift untuk membaca variabel

Untuk akses runtime ke variabel di iOS, file Configuration.swift digunakan, yang membaca nilai dari Info.plist melalui Bundle.main.object(forInfoDictionaryKey:). Pendekatan ini memastikan bahwa variabel ditentukan pada tahap build dan tersedia untuk aplikasi segera setelah startup. Nilai dibaca sekali saat inisialisasi modul dan di-cache untuk akses cepat selama siklus hidup aplikasi.

enum AppEnvironment {
    static var apiBaseURL: URL {
        guard let urlString = Bundle.main
            .object(forInfoDictionaryKey: "API_BASE_URL"),
              let url = URL(string: urlString as! String)
        else { fatalError("API_BASE_URL is not configured") }
        return url
    }

    static var isChatEnabled: Bool {
        Bundle.main.object(
            forInfoDictionaryKey: "FEATURE_CHAT_ENABLED"
        ) as? Bool ?? false
    }
}

Variabel lingkungan dalam proyek Android

Android mendukung variabel lingkungan melalui BuildConfig — kelas yang dihasilkan secara otomatis yang bidangnya ditentukan dalam file build.gradle modul. BuildConfig dibuat pada tahap kompilasi untuk setiap flavor dan tipe build secara terpisah. Ini memungkinkan nilai yang berbeda untuk debug dan release tanpa menggunakan operator kondisional dalam kode, yang meningkatkan kinerja dan keamanan.

Konfigurasi bidang BuildConfig

Bidang BuildConfig diatur melalui buildConfigField di defaultConfig atau di buildTypes tertentu. Untuk setiap lingkungan, buildType atau productFlavor terpisah dibuat. Ini memastikan isolasi konfigurasi yang ketat: debug menggunakan server lokal, release menggunakan produksi. Bidang BuildConfig diketik secara statis, yang menghilangkan kesalahan saat merujuknya dalam kode.

// build.gradle (Module: app)
android {
    defaultConfig {
        buildConfigField "String", "API_BASE_URL",
            "\"http://localhost:8080\""
    }
    buildTypes {
        debug {
            buildConfigField "String", "API_BASE_URL",
                "\"http://dev.api.itsectr.com\""
        }
        release {
            buildConfigField "String", "API_BASE_URL",
                "\"https://api.itsectr.com\""
        }
    }
}

gradle.properties untuk nilai bersama

File gradle.properties di root proyek menyimpan variabel global Gradle. Mereka dapat diakses di semua modul melalui sintaks $variableName dan digunakan untuk menentukan versi dependensi, flag build, dan kunci API. Tidak seperti BuildConfig, gradle.properties hanya berfungsi pada tahap konfigurasi Gradle, bukan pada runtime aplikasi. Oleh karena itu, kata sandi dan kunci API yang ditentukan dalam gradle.properties tidak terlihat dalam kode yang didekompilasi, karena hanya digunakan untuk menghasilkan BuildConfig pada tahap kompilasi.

# gradle.properties
SENTRY_DSN=https://key@sentry.io/project
MAPS_API_KEY=AIzaSy...

Untuk transmisi rahasia yang aman dalam proyek Android, disarankan menggunakan local.properties (dikecualikan dari VCS) atau memuat nilai dari variabel CI/CD ke build.gradle melalui System.getenv(). Ini memastikan bahwa kunci tidak masuk ke repositori. Saat mempublikasikan di Google Play Console, pastikan semua kunci debug telah diganti dengan versi produksi melalui buildTypes atau productFlavors yang berbeda dengan nilai BuildConfig yang sesuai.