android create

使用現有範本建立新的 Android 專案。您可以指定專案名稱、輸出目錄、minSdk 值和試執行。

用量

android create [-h] [--application-id=PARAM] [--force] [--list] [--min-sdk=PARAM] [--name=PARAM] [--namespace=PARAM] [--output=PARAM] [<template-name>]

選項

  • --application-id=PARAM:應用程式的應用程式 ID,例如 com.example.myapp。
  • --force - Allow creating the project in a non-empty directory, overwriting existing files.
  • -h,--help:顯示指定指令的說明訊息。
  • --list:列出所有可用範本。
  • --min-sdk=PARAM - 應用程式支援的 minSdk 值 (預設值定義於範本中)。
  • --name=PARAM - 應用程式名稱,例如 My Application。
  • --namespace=PARAM - 資源的命名空間和 Kotlin 來源檔案的套件名稱。
  • -o,--output=PARAM - 目的地專案目錄路徑 (預設值為 .)。

android 選項:

  • --sdk=PARAM - Android SDK 的路徑。
  • -v,--verbose - 啟用詳細輸出功能以利疑難排解。
  • -V,--version - 列印版本資訊並結束。

位置引數

  • <template-name>:範本名稱。

說明

android create 會使用官方專案範本,架構新的 Android 專案。

根據預設,如果省略 <template-name>,系統會使用預設的空白 Compose 活動範本。傳遞 --list,即可在建立專案前檢查所有可用的專案範本。

設定專案選項

  • --name:建立專案時必須提供。設定應用程式的顯示名稱 (例如 "My Application")。
  • -o, --output:設定專案檔案的寫入目的地目錄。預設為目前目錄 (.)。除非指定 --force,否則目錄必須不存在或為空白。
  • --force:允許在非空白目錄中建立專案。如果現有檔案的路徑與專案檔案相同,系統會覆寫這些檔案。
  • --application-id:設定用於建構及 Google Play 發布作業的專屬應用程式 ID (例如 com.example.myapp)。
  • --namespace:設定所產生 Android 資源 (R 類別) 的命名空間,以及預設的 Kotlin 套件名稱。
  • --min-sdk:覆寫範本的預設最低 API 級別 (minSdk)。

清單範本 (--list)

執行 android create --list,即可列印所有可用範本及其說明,不必建立專案。

範例

列出所有可用的專案範本:

android create --list

在 ./my-app 中建立新的 Android 專案,並自訂應用程式名稱和應用程式 ID:

android create --name="My Application" --application-id=com.example.myapp --output=./my-app

使用特定範本和最低 SDK 版本建立專案:

android create --name="Wear App" --min-sdk=30 --output=./wear-app empty-activity-compose