Android項目基本結構詳解

一、簡介

第3章雖然通過百度地圖應用展示了你可能感興趣的內容，但是，如果你是一個初學者，一開始就看懂和理解代碼可能會非常費勁。為了解決此問題，從這一章開始，本模塊將從最基本的內容講起，帶你逐步進入用C#進行Android應用開發的樂園。

二、AndroidApp入口

要用C#開發Android應用程序，首先需要對項目的基本結構有一個感性認識。如下圖所示：

Android應用程序使用的是單一入口，源程序中並不能一眼看出程序從哪開始運行，當應用程序加載到內存中時，Android操作系統會自動從內部自定義的入口處開始運行該應用程序。這種獨特的架構可讓程序員設計的代碼直接和Android操作系統交互，但其缺點也很明顯：即使一個非常簡單的程序，也會變得很復雜。

為了方便找到程序入口點，當新建一個Android項目時，默認情況下，在MainActivity.cs文件的特性聲明中通過“MainLauncher = true”表示程序從這個Activity開始執行：

[Activity(Label = "myDemos", MainLauncher = true)]

public class MainActivity : Activity

{

//……

}

注意MainActivity.cs的前綴，一般表示它控制的是布局文件Main.axml（但不是必須這樣做）。比如，如果把Main.axml改為First.axml，那麼它對應的Activity類最好命名為FirstActivity.cs，換言之，前綴只是為了方便查看它和界面的對應關系而已，這僅僅是一種命名習慣，而不是對文件命名的必然要求。

實際上，你可以把“MainLauncher = true”放到任何一個繼承自Activity的類中。總之，你將其放到哪個類的特性聲明中，程序就從哪個Activity開始執行。

三、資源文件（Resources文件夾下的各種文件）

資源文件是指在代碼中使用的並且在編譯時就被打包到應用程序中的附加文件。根據資源的類型，這些文件分別被保存在項目中的不同文件夾下。

在項目的Resources文件夾下，根據資源類型，可將其分為多個子文件夾。這些資源包括圖片，音頻文件，以及任何與程序可見內容相關的東西。例如，自定義的動畫、菜單、風格、顏色以及由.axml文件（帶設計界面）或.xml文件（不帶設計界面）描述的用戶交互頁面的布局等。

1、基本概念

Resources文件夾下保存的資源不包括代碼文件，而是指隨項目一起編譯和打包的除了代碼文件之外的其他文件，如聲音、視頻、圖像、字符串、布局文件等。

將資源單獨組織的優點是：代碼分離，這樣就可以適用於多平台，同時也能在編譯時進行檢查，並在編譯通過後為鍵入C#代碼提供智能提示。

使用資源可使修改程序的特征變得很容易，同時不必修改代碼。而且通過可選擇的資源集合，能為不同的設備配置優化程序（例如不同的國家語言和不同的屏幕尺寸等）。

系統搭建工具會自動為Android項目使用的每一個資源都定義一個唯一的整型ID，程序通過ID獲得代碼中的資源或者.xml或.axml中的其它資源的引用。例如，程序包含了一個名叫logo.png (保存在 Resources/drawable/ 目錄下)的圖片文件，工具就會生成一個叫做Resource.drawable.logo的資源ID，程序中可以用這個ID引用該圖片。

分隔資源的一個重要能力是為不同的設備配置提供可選擇的資源文件。例如，在XML中定義UI字符串，就可以把這些字符串翻譯成其它的國家語言，並在分隔的文件中分別保存。然後，根據追加到資源目錄名中的國家語言修飾符（例如res/values-fr/是法語字符串的值）和用戶對國家語言的設置，Android系統就會提供適當的國家語言字符串到UI中。

Android支持很多不同的修飾符以支持可選的資源。這些修飾符都是被加入到資源目錄名中的簡短字符串。這樣定義是為了定義設備的特定配置，以保證這個目錄下的資源可能會被使用到。

2、基本的資源文件夾

基本的資源文件夾用於保存項目中常用的資源文件。

（1）Drawable文件夾

Drawable文件夾：保存通用的圖片文件。

Drawable resources（可繪制資源）是編譯到應用程序中的圖像資源，這些資源可通過API去調用或引用其他的XML資源。例如，位圖文件 (.png、.gif、.jpg)、可調整大小的9-Patch格式的圖像、在XML文件中定義的狀態列表、通用的形狀定義、……等。

通過Resources.Drawable獲取該文件夾下的這些文件資源。

說明：9-Patch圖像（*.9.png）的含義及用法見本博客第5章介紹的圖像示例。

（2）其他與分辨率對應的圖片資源文件夾

其他與分辨率對應的相關文件夾還有：

drawable-ldpi文件夾：保存低分辨率手機專用的圖片文件。

drawable-mdpi文件夾：保存中等分辨率手機專用的圖片文件。

drawable-hdpi文件夾：保存高分辨率手機專用的圖片文件。

drawable-xdpi文件夾：保存超高分辨率手機專用的圖片文件。

drawable-xxdpi文件夾：保存超超高分辨率手機專用的圖片文件。

（3）layout文件夾

layout文件夾用於保存所有界面文件（包括帶設計界面的.axml文件和不帶設計界面的.xml文件），如果你高興，可隨時將.xml換名為.axml，或者隨時將.axml換名為.xml。

一般用Main.axml作為默認的App主頁布局文件，有Design和Source兩種模式。

該文件夾下的文件都是可編譯為屏幕布局的XML文件，可通過Resources.Layout獲取這些文件資源，通過Resources.Id獲取這些文件中用id定義的資源。

（4）Values文件夾

Values文件夾存放用字符串描述的XML文件，該文件夾下的這些文件中包含的都是一個或多個簡單的字符串類型的值或列表（strings、integers、colors等）。比如在一個XML文件中用字符串列表定義一系列顏色。

Values文件夾資源文件都是文本資源，在文件夾中有一些約定的文件名稱。另外，該目錄下的XML文件中的值可定義多個資源而不是只能定義單個資源，例如：

String.xml：保存字符串值列表，通過Resources.String獲取這些資源。Colors.xml：保存顏色值列表，通過Resources.Color獲取這些資源。Arrays.xml：定義數組，通過Resources.Array獲取這些資源。Dimens.xml：保存尺度值，通過Resources.Dimens獲取這些資源。

（5）animator文件夾

該文件夾下保存的是用屬性動畫描述對象的動畫的XML文件。其用法和WPF的屬性動畫相似，是一種非常靈活而強大的描述動畫的方式，可描述各種類型的對象。

“屬性動畫”是在API level 11 (Android 3.0)開始提供的。

注：Android的屬性動畫和WPF的屬性動畫的用法非常相似，只要學會其中一種，很快就會另一種的用法。

（6）anim文件夾

該文件夾用於保存描述補間動畫（tween animations）的XML文件。

補間動畫用一系列的動畫指令對視圖對象的內容執行轉換，用於將View對象轉換為動畫，比如邊旋轉邊增大圖像或文本的大小。

由於旋轉圖像或文本會導致占用的容量快速膨脹，因此補間動畫只能用於View對象。

（7）color文件夾

該文件夾用於保存描述顏色狀態列表的XML文件。顏色狀態列表是指用顏色表示每個狀態的變化，比如按鈕按下、禁用等。要讓按鈕的隨著狀態的變化而引起顏色的改變，就需要定義這樣一個顏色狀態列列表，用它來描述這些顏色狀態的變化。

（8）menu文件夾

該文件夾保存的是描述菜單的XML文件，如【應用程序選項】菜單、彈出菜單、上下文菜單（快捷菜單）、子菜單等。

通過Resources.Menu獲取該文件夾下的這些文件資源。

（9）raw文件夾

用原始的二進制形式保存的任意文件。這些文件仍然以二進制文件的形式被編譯到Android應用程序中。

通過Resources.Raw可獲取該文件夾下的這些文件資源。

（10）xml文件夾

該文件夾下保存的XML文件類似於.NET的配置文件，即：該文件夾下保存的都是可以由應用程序在運行時讀取的任意XML文件。

通過Resources.Xml獲取這些資源。

4、引用資源的方式

當將資源文件添加到項目中時，管道會自動將該資源描述添加到資源中，並自動生成對應的類（保存在Resource.designer.cs文件中），自動生成的類會為每個資源自動分配一個唯一的ID。

有兩種存取和管理資源的方式：

-----在C#代碼中引用資源。

-----在.xml或者.axml布局文件中引用資源。

（1）方式1--在C#代碼中引用資源

格式：@[<PackageName>.]Resource.<ResourceType>.<ResourceName>

例如：

復制代碼 代碼如下:SetContentView(Resource.Layout.Main);EditText phoneNumberText = FindViewById<EditText>(Resource.Id.PhoneNumberText);

（2）方式2--在xml（或者axml）布局文件中引用資源

格式：@[<PackageName>:]<ResourceType>/<ResourceName>

例如（見Main.axml文件）：

復制代碼 代碼如下:<?xml version="1.0" encoding="utf-8"?><LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" android:orientation="vertical" android:layout_width="fill_parent" android:layout_height="fill_parent"> <ImageView android:id="@+id/myImage" android:layout_width="wrap_content" android:layout_height="wrap_content" android:src="@drawable/flag" /></LinearLayout>

5、其他備用的資源文件夾

備用資源也是保存在Resources文件夾下，子文件夾的格式為：

<ResourceType>-<Qualifier>

即：<資源類型>-<限定標識符>

例如：drawable-hdpi

當有多個限定符時，各限定符之間用短劃線分隔。

限定符必須按下表列出的順序出現（該表實際是按優先級從高到低排列）：

例如，v11的目標是API level 11 (Android 3.0)設備。

下面是截圖表格中各限定符的含義。

MCC、MNC

手機的國家碼（MCC）：手機的SIM卡提供商。

移動網絡碼（MNC）：手機連接到的網絡供應商。

盡管本地化目標可以使用用於移動設備的國家碼，但是仍建議使用資源限定符來限定它。例如：美國（U.S）的資源限定符是 mcc310-mnc026

MCC的完整編碼詳見下面的網站：http://mcclist.com/

Language

兩字母的ISO 639-1國家語言編碼以及可選的兩字母的ISO-3166-alpha-2區域編碼。 如果同時提供這兩個限定符，用“-r”分隔。

例如：對於French-Canadian locales，使用的資源限定符為：fr-rCA

完整的語言和區域編碼見“Codes for the Representation of Names Of Languages and Country names and code elements”。

Smallest Width

限定屏幕執行時使用的最小寬度。例如：sw320dp 表示目標設備的高和寬最小說320dp。

Available Width、Available Height

Available Width：屏幕最小寬度，格式：w<N>dp，其中N表示與像素無關的寬度。當用戶旋轉屏幕時會改變該值。例如：w720dp 表示目標設備的最小寬度為720dp

Available Height：屏幕最小高度，格式：h<N>dp，其中N表示與像素無關的寬度。當用戶旋轉屏幕時會改變該值。例如：h720dp 表示目標設備的最小高度為720dp

Screen aspect

指屏幕的寬高比，而不是屏幕的放置順序（縱向和橫向）。其值有兩個：long（表示寬屏幕）、notlong（表示非寬屏幕）。

Screen Orientation

屏幕放置順序，Portrait（縱向放置）或者landscape（橫向放置）。該值可在應用程序的生命周期中改變。取值有：port、land

Dock mode

設備在 car dock或者 desk dock 中。API 8（Android 2.2.x）開始提供。取值有：car、desk

Night mode

應用程序是否在夜間模式下運行。此限定可給開發者在應用程序生命周期中提供優化選項。API level 8 (Android 2.2.x)開始提供。

可能的值：night、notnight

Screen pixel density (dpi)

物理屏幕的像素數，通常用dpi表示。可能的值有：

ldpi – 低分辨率屏幕

mdpi – 中等分辨率屏幕

hdpi – 高分辨率屏幕

xhdpi – 超高分辨率屏幕

nodpi – 資源不可縮放

tvdpi – 在mdpi和hdpi之間

Touchscreen type

限定設備是哪種觸摸屏。可能的值有：notouch (無觸摸功能)、stylus（適用於手寫筆的電阻式觸摸屏）、finger（手指觸摸）

Keyboard availability

限定哪種鍵盤可用。可在應用程序的生命周期中改變它。可能的值有：

keysexposed – 該設備有可用的鍵盤。如果軟鍵盤不可用，則當【硬件鍵盤】設置打開時僅使用硬鍵盤。

keyshidden – 設備沒有硬鍵盤，而且軟鍵盤也隱藏。即：軟件沒有可以用的鍵盤。

keyssoft –設備有可用的軟鍵盤。

Primary text input method

限定哪種硬件鍵盤可用於輸入。可能的值有：

nokeys – 無可用的用於輸入文本信息的硬件鍵盤。

qwerty – 有可用的qwerty鍵盤。

12key – 有可用的12-鍵（12-key）硬件鍵盤。

Navigation key availability

用於當“5-way”或者“d-pad (directional-pad)”導航鍵可用的情況。可在應用程序生命周期中改變。可能的值有：

navexposed – 用戶可以使用導航鍵。

navhidden – 導航鍵不可用。

Primary non-touch navigation method

設備提供的可用導航鍵。可能的值有：

nonav – 僅能通過觸摸屏幕導航。

dpad – 有可用的“d-pad (directional-pad)”導航。

trackball – 設備有一個“trackball”用於導航。

wheel - （不常見）有一個或多個可用的定向輪

Platform version (API level)

設備支持（supported）的API級別。格式：v<N>

下圖列出了Android的判斷規則：

四、附件（Assets文件夾下的各種文件）

在Android App中，Asset文件夾及其子文件夾下可保存任意類型的原始文件：text、xml、fonts、music、video、……等（WPF的內容文件類型也是如此，換言之，如果你知道如何用C#讀寫WPF項目中的內容文件，也就知道如何用C#讀寫Android項目中Asset文件夾下的原始文件了）。

與資源文件不同，Asset文件夾下的文件不是被編譯到Android應用程序內，而是以單獨的原始（raw）文件的形式作為附件隨Android App一起打包到.apk壓縮文件包中發布出來。

和WPF的比較：在WPF中，將這種文件稱為內容文件，WPF是通過文件屬性來指定編譯器如何處理這種文件的（復制到輸出目錄：總是復制、如果較新則復制等），但是WPF並沒有規定必須將這種類型的文件保存到項目中的哪個文件夾及其子文件夾下。而Android規定必須將這種類型的文件保存到項目中的Asset文件夾及其子文件夾下，而且規定只能通過Assets類來打開該文件夾下的文件。

下面的代碼演示了如何讀取Assets下的文本文件並將其顯示到界面上：

using Android.App;
using Android.OS;
using Android.Widget;
using System.IO;
namespace MyTestProj
{
  [Activity(Label = "Activity1")]
  public class Activity1 : Activity
  {
    protected override void OnCreate(Bundle savedInstanceState)
    {
      base.OnCreate(savedInstanceState);
      base.OnCreate(savedInstanceState);
      var textView1 = new TextView(this);
      string content;
      using (StreamReader sr = new StreamReader(Assets.Open("readme.txt")))
      {
        content = sr.ReadToEnd();
      }
      textView1.Text = content;
      SetContentView(textView1);
    }
  }
}

在Android應用程序中，每個組件都是一個獨立的模塊，但並不是所有組件都是用戶進入程序的真實入口，其中一些要依賴於其它組件。

Android內置了四種不同的應用程序組件：Activity、Service、Content Provider和Broadcast recevicer。除此之外，還可以自定義組件並將其保存到項目的Components文件夾下。

在後面的章節中，還會專門介紹這些內容，這裡你只需要記住真正掌握Android應用開發技術，必須理解這些組件的含義和具體使用場合。

六、權限設置與管理（AndroidManifest.xml）

清單(Manifest)可以定義應用程序及其組件的結構和元數據。

AndroidManifest.xml文件包含在每個安卓應用程序中，該文件向系統描述了本程序所包括的組件、所實現的功能、所能處理的數據、要請求的資源等。

該文件的功能類似於網站中的Web.conig文件。

在AndroidManifest.xml文件中添加或刪除權限時，最常用的是通過VS2015主菜單下的項目屬性來設置與權限（Permissions）相關的屬性：

也可以在【解決方案資源管理器】中雙擊項目的【Properties】文件夾直接進入該界面。

設置後，它會自動更新項目中Properties文件夾下的AndroidManifest.xml文件。如果項目的Properties文件夾下不存在該文件，系統會自動創建它。

在Android系統能夠啟動一個程序組件之前, 系統必須通過讀取程序的AndroidManifest.xml文件來知道這個組件是否存在。因此對於Java開發者要求程序必須在這個文件中聲明它所有的組件。

除了聲明程序組件外，這個配置文件還做一些其它的工作，例如：

確定程序需要哪些用戶權限，例如網絡訪問或者讀取用戶的聯系人。聲明程序需要的最小的 API Level 這個要參照程序都使用了哪些API。聲明程序使用或要求的硬件和軟件特性，例如相機，藍牙服務，或者多點觸屏。程序需要鏈接的API類庫(除Android framework API之外的類庫),例如 Google Map類庫。

但是，如果用C#來開發，“直接在AndroidManifest.xml文件中聲明”並不是必需的，因為用帶有智能提示的特性聲明來聲明它，然後讓編譯器自動生成合適的代碼添加到這個文件中更方便。

當然，如果你希望直接在該文件中添加聲明，也可以這樣做。換言之，C#開發給你提供了多種聲明清單的方式，你只需要按自己的習慣去選擇一種合適的方式即可。這些方式有：

在AndroidManifest.xml文件中直接添加聲明。通過項目的屬性窗口選擇，然後讓編譯器自動將合適的代碼添加到AndroidManifest.xml文件中。在AssemblyInfo.cs文件中聲明，然後讓編譯器自動自動將合適的代碼添加到AndroidManifest.xml文件中。通過在類上方添加特性聲明來聲明，然後讓編譯器自動自動將合適的代碼添加到AndroidManifest.xml文件中。

通過這些方式，你就擁有了最大的靈活性，同時也是代碼看起來簡潔而直觀。

七、CPU架構（CPU Architectures）

VS2015調試模式（Debug）使用的是可適應多種CPU架構的模式，發布模式（Release）用於選擇某種具體型號的手機，然後部署。

（1）如何指定支持的CPU架構

在調試狀態（Debug）下，下面的兩個選項默認是選中的：

這兩個選項選中後。可防止調試時指定某種具體的CPU架構（CPU Architectures），即在下面的配置中，下面這些選項是不可更改的：

通常情況下，實際發布應用程序時需要明確配置使用的CPU體系結構或架構。當更改為發布（Release）模式時，它會自動不勾選“Use Shared Runtime”和“Use Fast Delployment…”復選框，這樣一來，上圖中的選項就可選了。

Xamarin.Android提供下面的架構：

armeabi – 基於ARM的CPU系列，提供了不低於ARMv5TE結構的指令集。注意armeabi不是線程安全的而且不能用於多CPU的設備。armeabi-v7a – 這種CPU支持硬件浮點運算和多CPU(SMP)設備。注意armeabi-v7a的機器碼無法在ARMv5設備上運行。arm64-v8a –這是一種基於64-bit ARMv8架構的CPU。x86 – 這種CPU提供x86 (or IA-32)指令集。該指令集等價於奔騰Pro（Pentium Pro），包括MMX, SSE, SSE2,以及SSE3指令集。x86_64 CPUs提供64-bit的x86指令集。

在Release模式下，Xamarin.Android默認指定的是armeabi-v7a，其性能比armeabi高。如果發布目標是64-bit ARM平台(例如Nexus 9)，此時需要選擇arm64-v8a。如果發布到x86設備，就選擇x86，如果發布目標是64-bit的CPU架構，就選擇x86_64。

注意：由於在64位架構上可運行32位程序（例如Nexs 9就是64-bit ARM設備），因此，發布到64位手機設備上的時候，不是必須選擇arm64-v8a或x86_64，仍然可以繼續選擇32位架構，這樣做的優點是可避免應用程序占用過多的內存。

（2）多平台目標（Targeting Multiple Platforms）

面向多平台的優點是可同時調試多種CPU，缺點是這會導致.apk文件很大，如果希望減少.apk文件的大小，發布時只選擇一個平台就行了。

注意：雖然在Xamarin.Android 5.1.x或更高版本中也可以體驗64位的功能，但實際發布時並不使用它。

以上就是本文的全部內容，希望對大家的學習有所幫助，也希望大家多多支持本站。