建立新 Android 專案時,IDE 會自動產生基礎程式碼結構。理解各檔案用途並學會客製化範本,能加速後續開發。本文解析預設生成內容並示範常見調整。
public class MainActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
}
}
| 路徑 | 用途 |
|---|---|
app/src/main/java/.../MainActivity.java | 主進入點 Activity |
app/src/main/res/layout/activity_main.xml | 對應 UI 佈局 |
app/src/main/AndroidManifest.xml | 元件宣告、權限、主題、啟動器 IntentFilter |
app/build.gradle.kts | 模組級建構腳本:依賴、編譯選項、版本 |
gradle/libs.versions.toml | 版本目錄 (TOML) 集中管理依賴版本 |
BaseActivity 封裝通用邏輯(權限請求、工具列、狀態列顏色、夜間模式)。ViewBinding / DataBinding:在 buildFeatures { viewBinding = true } 啟用後,自動生成 Binding 類別,取代 findViewById。MyApplication 初始化第三方 SDK、全域異常捕獲、資料庫實例。compileOptions { sourceCompatibility = JavaVersion.VERSION_17 }、kotlinOptions { jvmTarget = "17" }。File → Settings → Editor → File and Code Templates 修改 Activity/Fragment/Adapter 範本,貼上團隊規範的註解、導入順序、生命週期骨架。| 參數 | 說明 | 建議 |
|---|---|---|
| Package Name | 應用唯一識別碼 (如 com.company.app) | 採用反向網域名,全小寫,不可變更 |
| Minimum SDK | 支援最低 API 等級 | 依用戶分佈權衡,建議 API 24+ (Android 7.0) |
| Language | Kotlin / Java | 新專案優先 Kotlin |
| Build System | Gradle Kotlin DSL (.kts) / Groovy | 推薦 .kts 享有型別安全與 IDE 支援 |
Refactor → Rename 重構套件名,同步更新 Manifest、build.gradle、import 陳述式。themes.xml 父主題改為 Theme.MaterialComponents.DayNight.NoActionBar。熟悉自動生成結構並建立團隊專屬範本,能讓每個新專案起跑就符合規範。