Android Project Structure: Manifest, Resources & Gradle

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools">

    <!-- 1. Hardware & Network Permissions -->
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
    <uses-feature android:name="android.hardware.camera" android:required="false" />

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/Theme.DevAscent">

        <!-- 2. Primary Entry-Point Launcher Activity -->
        <activity
            android:name=".ui.MainActivity"
            android:exported="true">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>

        <!-- 3. Private Internal Detail Activity -->
        <activity
            android:name=".ui.DetailActivity"
            android:exported="false" />
    </application>

</manifest>

android {
    namespace = "com.devascent.academy"
    compileSdk = 34

    defaultConfig {
        applicationId = "com.devascent.academy"
        minSdk = 24
        targetSdk = 34
        versionCode = 101          // Monotonically increasing integer for Google Play updates
        versionName = "1.0.1"      // Semantic version visible to users
    }

    flavorDimensions += "tier"
    productFlavors {
        create("dev") {
            dimension = "tier"
            applicationIdSuffix = ".dev"
            versionNameSuffix = "-dev"
        }
        create("prod") {
            dimension = "tier"
        }
    }

    buildTypes {
        debug {
            applicationIdSuffix = ".debug"
            isDebuggable = true
        }
        release {
            isMinifyEnabled = true
            proguardFiles(getDefaultProguardFile("proguard-android-optimize.txt"), "proguard-rules.pro")
        }
    }
}

package com.devascent.academy.ui

import android.Manifest
import android.content.pm.PackageManager
import android.os.Bundle
import android.util.Log
import android.widget.Button
import android.widget.TextView
import android.widget.Toast
import androidx.activity.result.contract.ActivityResultContracts
import androidx.appcompat.app.AppCompatActivity
import androidx.core.content.ContextCompat
import com.devascent.academy.R

class ArchitectureDiagnosticsActivity : AppCompatActivity() {
    private val tag = "DevAscent_Arch"
    private lateinit var statusLabel: TextView

    // Modern AndroidX Runtime Permission Request Contract
    private val cameraPermissionLauncher = registerForActivityResult(
        ActivityResultContracts.RequestPermission()
    ) { isGranted: Boolean ->
        if (isGranted) {
            updateSecurityStatus("CAMERA ACCESS: GRANTED BY USER", true)
        } else {
            updateSecurityStatus("CAMERA ACCESS: DENIED BY USER", false)
            Toast.makeText(this, "Camera feature unavailable without permission", Toast.LENGTH_SHORT).show()
        }
    }

    @Override
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_diagnostics)

        statusLabel = findViewById(R.id.tv_security_status)
        val verifyButton: Button = findViewById(R.id.btn_verify_permission)

        // 1. Inspect R class Resource Strings
        val appName = getString(R.string.app_name)
        Log.i(tag, "Loaded resource string: $appName")

        // 2. Trigger Runtime Permission Flow
        verifyButton.setOnClickListener {
            checkAndRequestCameraPermission()
        }
    }

    private fun checkAndRequestCameraPermission() {
        val permission = Manifest.permission.CAMERA
        when {
            ContextCompat.checkSelfPermission(this, permission) == PackageManager.PERMISSION_GRANTED -> {
                updateSecurityStatus("CAMERA ACCESS: ACTIVE (PREVIOUSLY GRANTED)", true)
            }
            shouldShowRequestPermissionRationale(permission) -> {
                Toast.makeText(this, "Camera is required to scan QR enrollment codes", Toast.LENGTH_LONG).show()
                cameraPermissionLauncher.launch(permission)
            }
            else -> {
                cameraPermissionLauncher.launch(permission)
            }
        }
    }

    private fun updateSecurityStatus(msg: String, isSuccess: Boolean) {
        statusLabel.text = msg
        val colorRes = if (isSuccess) R.color.emerald_500 else R.color.slate_900
        statusLabel.setTextColor(ContextCompat.getColor(this, colorRes))
        Log.d(tag, "Security Status Update: $msg")
    }
}