安卓開發 第1章 開始啟程——你的第一行Android代碼

1.3 創建第一個Android專案

1.3.1 創建HelloWorld專案

歡迎界面點擊Start a new Android Studio project，打開創建新專案頁面：

選擇Empty Activity模板，應用名HelloWorld，兼容最低版本安卓4.0.3.

1.3.2 啟動模擬器

1.3.4 分析你的第一個Android應用

將Android結構切換為Project結構易于理解：

1. .gradle和.idea

Android Studio自動生成檔案，無需關心，也不用手動編輯，

2.app

專案中的代碼，資源等內容幾乎都是放置在這個目錄下的，我們的后續開發作業也基本上是在這個目錄下進行的，

3.build

主要包含了在編譯時自動生成的檔案，不用多加關心，

4.gradle

這個目錄下包含了gradle wrapper的組態檔，

5. .gitignore

這個檔案用來將指定的檔案或目錄排除在版本控制之外，

6.build.gradle

這是專案全域的gradle構建腳本，通常這個里面的內容是不用修改的，

7.gradle.properties

這個檔案是全域的gradle組態檔，在這里的屬性將會影響到專案中所有的gradle編譯，

8.gradlew和gradlew.bat

這兩個檔案是為了在命令列界面執行gradle命令的，其中gradlew是在Linux或者Mac上使用的，.bat是在Windows上使用的，

9. HelloWorld.iml

iml檔案是IntelliJ IDEA專案都會自動生成的一個檔案，用于標識這是一個IntelliJ IDEA專案，我們不需要改變這個檔案的任何內容，

10.local.properties

這個檔案用來指定本機中的SDK路徑，通常都是自動生成的，不用修改，除非我們的SDK位置發生變化，那么只需要改成新的位置就可以了，

11.settings.gradle

用于指定檔案專案中引入的模塊，這里面只引入一個模塊app，通常情況下模塊引入都是自動引入的，我們需要修改的情況較小，

除了app目錄之外，大部分都是自動生成的，因此我們要對app模塊有更加深入的了解：

1. build

主要包含編譯自動生成的檔案，里面的內容比外層更復雜，不需要過多關心，

2.libs

專案中使用的第三方jar包，就需要放在libs下，這個目錄下的包都會被自動添加到構建目錄中去，

3.androidTest

此處是用來撰寫Android Test測驗用例的，可以對專案做一些自動化測驗，

4. java

這里是你所有Java代碼的地方，打開后MainActivity檔案就在里面，

5.res

專案中使用的圖片，布局，字串等資源都必須放在這個目錄下，圖片放在drawable，布局檔案放在layout下，字串放在values下，

6.AndroidManifest.xml

這是你整個Android專案的組態檔，你在程式中定義的四大組件都需要在這個檔案注冊，另外還可以在這個檔案中給應用程式添加權限宣告，由于這個檔案以后會經常用到，用到時會做詳細說明，

7.test

撰寫Unit Test用例，另一種自動化測驗方式，

8. .gitignore

用于將app模塊指定的目錄排除在版本控制之外，和外層的ignore檔案相似，

9.app.xml

IntelliJ IDEA自動生成的檔案，不需要關心或者修改這個檔案的內容，

10. build.gradle

app模塊中的gradle構建腳本，會指定許多專案構建相關的配置，

11.proguard-rules.pro

用來指定代碼的混淆規則，當代碼開發完成后，不希望別人破解代碼，就會對代碼進行混淆，

首先了解HelloWorld專案是怎么運行的，下面是AndroidManifest.xml檔案，里面有以下代碼：

 <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>

這段代碼表示對MainActivity這個活動的注冊，沒有在AndroidManifest.xml注冊的活動是不能使用的，3和4行代碼表示的是手機上點擊應用圖示，打開的就是這個活動，

四大組件：

活動（Activity），服務（Service），廣播接收器（Broadcast Receiver），內容提供器（Content Provider），活動是所有Android應用程式的門面，凡是應用中看得到的東西，都放在活動中，服務比較低調，無法看到他，但是會在后臺靜默運行，廣播接收器允許你的應用接受來自各處的廣播訊息，例如電話，短信等，你的應用也可以向外廣播，內容提供器為應用程式共享提供了可能，比如讀取聯系人資訊，

看一下活動代碼：

public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
    }
}

MainActivity是從AppCompatActivity繼承來的，這是向下兼容的Activity，最低兼容到Android 2.1.Activity是安卓系統提供的一個活動基類，我們所有活動都必須繼承它或者它的子類才能擁有活動特性（AppCompatActivity是Activity的子類），可以看到onCreate方法，這是活動要被創建必須執行的一個方法，

Android講究邏輯和視圖分離，因此是不推薦活動中直接撰寫界面，第6行的setContentView引入了activity_main布局，布局檔案都在res/layout下，打開后切換到Text視圖：

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_
    android:layout_height="match_parent"
    tools:context=".MainActivity">

    <TextView
        android:layout_
        android:layout_height="wrap_content"
        android:text="Hello World!"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintLeft_toLeftOf="parent"
        app:layout_constraintRight_toRightOf="parent"
        app:layout_constraintTop_toTopOf="parent" />

</androidx.constraintlayout.widget.ConstraintLayout>

android:text="Hello World!"提供了我們的字串，

1.3.5 詳解專案中的資源

• drawable——圖片
• mipmap——圖示
• values——字串，顏色，樣式
• layout——布局

mipmap這么多是為了應對不同的解析度，

如何使用這些資源？

打開res/values/strings.xml

<resources>
    <string name="app_name">HelloWorld</string>
</resources>

這里定義了一個應用名字的參考，你有兩種參考方式：

• 代碼中通過R.string.app_name可以獲得該字串的參考
• XML中通過@string/app_name即可獲得參考

string的部分是可以更換的，例如drawable，mipmap或者layout，

1.3.6 詳解build.gradle檔案

Android Studio是通過Gradle構建專案的，是一個非常先進的專案構建語言，先看外層目錄下的：

// Top-level build file where you can add configuration options common to all sub-projects/modules.

buildscript {
    repositories {
        google()
        jcenter()
        
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:3.5.3'
        
        // NOTE: Do not place your application dependencies here; they belong
        // in the individual module build.gradle files
    }
}

allprojects {
    repositories {
        google()
        jcenter()
        
    }
}

task clean(type: Delete) {
    delete rootProject.buildDir
}

兩處repositories閉包里面都宣告了jcenter，這是一個托管倉庫，宣告這行配置之后，我們就可以在專案中參考jcenter上面的開源專案，

dependcies閉包里面使用classpath宣告了一個Gradle插件，宣告的原因是Gradle不是專門為Android開發的，因此需要宣告，

下面是內層的build.gradle檔案：

apply plugin: 'com.android.application'

android {
    compileSdkVersion 29
    buildToolsVersion "29.0.3"
    defaultConfig {
        applicationId "com.example.helloworld"
        minSdkVersion 15
        targetSdkVersion 29
        versionCode 1
        versionName "1.0"
        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
}

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    implementation 'androidx.appcompat:appcompat:1.0.2'
    implementation 'androidx.constraintlayout:constraintlayout:1.1.3'
    testImplementation 'junit:junit:4.12'
    androidTestImplementation 'androidx.test.ext:junit:1.1.0'
    androidTestImplementation 'androidx.test.espresso:espresso-core:3.1.1'
}

第一行應用了一個插件，有兩種值可選：com.android.application表示是一個應用程式模塊，com.android.library表示是一個庫模塊，區別在于，應用模塊可以直接運行，庫模塊作為代碼庫需要依附于別的應用模塊運行，

接下來是大的android閉包，可以配置安卓資訊，

• compileSdkVersion——SDK版本

• buildToolsVersion——專案構建工具版本

• defaultConfig閉包：

  • applicationId——包名，后期在這里修改包名
  • minSdkVersion——最低兼容版本
  • targetSdkVersion——已在該目標版本做過充分測驗
  • versionCode——版本號
  • versionName——版本名

• buildTypes閉包：

  • debug閉包：指定生成測驗檔案的配置，可以不寫
  • release閉包：
    • minifyEnabled——是否對代碼進行混淆
    • proguardFiles——混淆規則
    • proguard-android-optimize.txt——在Android SDK下，是所有專案通用混淆規則
    • proguard-rules.pro——當前根目錄下特有混淆規則

• dependencies閉包：指定當前專案所有依賴關系

  通常有3種依賴方式：

  1. 本地依賴——通過jar包或者目錄
  2. 庫依賴——對專案的庫模塊添加依賴關系
  3. 遠程依賴——對jcenter的開源專案進行依賴
  • implementation fileTree——本地依賴宣告，把libs目錄下所有.jar檔案加入構建路徑
  • implementation——遠程依賴格式
  • 庫依賴沒有用到，宣告格式為compile project(':helper')，如果庫名是helper，

1.4 日志工具的使用

1.4.1 使用Android的日志工具Log

• Log.v——列印瑣碎的，意義最小的日志資訊，對應級別verbose，是級別最低的一種，
• Log.d——列印除錯資訊，對除錯程式和分析程式有幫助，對應級別debug，
• Log.i——列印比較重要的資料，這是很想看到的，分析用戶行為，級別info，
• Log.w——列印警告資訊，有潛在的風險，最好去修復這些地方，級別warn，
• Log.e——列印錯誤資訊，比如程式進入catch陳述句中，必須修復，對應級別error，

在onCreate里面加入這么一行陳述句：

import android.util.Log;    //一定要匯入否則會出錯

public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        Log.d("MainActivity","onCreate execute");
    }
}

第一個引數是tag，一般傳入當前類名，第二個是msg，是具體要列印的內容，

運行結果：

1.4.2 為什么使用Log而不是System.out

快捷輸入：

• logi+Tab打下info級別的日志
• onCreate方法外輸入logt+Tab自動生成TAG常量
• 還可以自定義Filter

標籤：其他

上一篇：HMS Core 6.3.0 版本發布公告

下一篇：在一個函式中讀取JSON以使用其他函式中的值