android官方技術(shù)文檔翻譯――Android Lint

$ lint --html /tmp/report.html

默認(rèn)情況下，鏈接到源代碼文件將只使用本地的 file:// 路徑資源。您可以通過(guò) --url 選項(xiàng)把 URL 重新映射向不同的前綴。例如：

$ lint --html /tmp/report.html --url /src/MyProj=http://buildserver/src/MyProj

其他命令行選項(xiàng)

運(yùn)行l(wèi)int --help以獲取可用參數(shù)的相關(guān)信息。

Eclipse 中的用法

注： 此文檔是在 lint 首次發(fā)布時(shí)編寫的。Eclipse 集成已經(jīng)有了顯著的提高。欲了解更多最新的詳細(xì)信息，請(qǐng)參閱新的Eclipse Lint UI(New Eclipse Lint UI)， 布局編輯器 Lint 反饋(Layout Editor Lint Feedback) 和 Lint 保存(Lint On Save).

Lint 在 ADT 16及更高的版本上集成。該集成 提供了上述 Lint 命令行版本的幾個(gè)功能：

自動(dòng)修復(fù)許多警告

Lint 可以在各種編輯器操作中自動(dòng)運(yùn)行

屏幕某些錯(cuò)誤類型及特定的錯(cuò)誤實(shí)例

配置問(wèn)題檢查嚴(yán)重程度

從 lint 視圖直接跳轉(zhuǎn)到問(wèn)題源碼

Lint 自動(dòng)化

在以下情況時(shí) lint 會(huì)自動(dòng)運(yùn)行：

導(dǎo)出 APK。在這種情況下,會(huì)以特殊模式運(yùn)行 lint，它將只查找致命錯(cuò)誤 (這樣會(huì)更快)，并且如果發(fā)現(xiàn)了任何錯(cuò)誤的時(shí)候會(huì)中止導(dǎo)出。你可以在 Lint 選項(xiàng)中關(guān)閉它。

編輯并保存和 XML 文件，例如布局文件或清單文件。在這種情況下，所有適用于給定文件的文件范圍檢查都會(huì)運(yùn)行，并且會(huì)為任何已發(fā)現(xiàn)的問(wèn)題加上編輯器的標(biāo)記。

使用布局編輯器。每個(gè) UI 操作后，在布局文件上會(huì)運(yùn)行文件范圍檢查 (如各種 layoutopt 規(guī)則)，并且結(jié)果將顯示在一個(gè)特別的 lint 窗口(當(dāng)發(fā)現(xiàn)錯(cuò)誤時(shí)它可以從顯示在布局編輯器的右上角的錯(cuò)誤標(biāo)記中打開(kāi))。

Lint 窗口

要在一個(gè)項(xiàng)目上運(yùn)行 Lint，請(qǐng)?jiān)诎鼮g覽器中選擇項(xiàng)目，然后單擊 Lint 工具欄上的功能(見(jiàn)下面的圖片)。

或者您可以在項(xiàng)目上右擊，在 Android Tools 子菜單中，有一個(gè)“運(yùn)行 Lint”的功能。它將打開(kāi)一個(gè) Lint 窗口，其中包含各種錯(cuò)誤。選擇一個(gè)錯(cuò)誤將會(huì)在右側(cè)的文本區(qū)顯示相關(guān)聯(lián)的解釋。

如果 lint 視圖上有任何錯(cuò)誤，你可以在錯(cuò)誤上雙擊，來(lái)跳轉(zhuǎn)到相關(guān)聯(lián)的源代碼位置。每個(gè)警告圖標(biāo)將顯示其嚴(yán)重程度，并具對(duì)于已修復(fù)的警告(見(jiàn)下一節(jié))會(huì)有一個(gè)小燈泡重疊。

該窗口也有一個(gè)操作欄(在右上角)，它可以讓你

再次運(yùn)行 lint 檢查以刷新結(jié)果 (在刷新期間它會(huì)變成一個(gè) Stop 按鈕，用于中止檢查)

如果有錯(cuò)誤，運(yùn)行與此錯(cuò)誤相關(guān)聯(lián)的修復(fù)

忽略此修復(fù)

刪除警告標(biāo)記

刪除所有的警告標(biāo)記

快速修復(fù)

許多 lint 警告有自動(dòng)修復(fù)功能。例如，各種 layoutopt 修復(fù)的替換提示 (如替換 wrap_content 為 0dp)。

從 lint 視圖中，單擊燈泡來(lái)調(diào)用一個(gè)修復(fù)程序。

從布局編輯器警告摘要中，單擊修復(fù)按鈕來(lái)修復(fù)。

從 XML 代碼編輯器中，調(diào)用快速修復(fù) (Ctrl+1 或Command+1)并選擇與該警告關(guān)聯(lián)的快速修復(fù)。

取消錯(cuò)誤警告的顯示

從編輯器快速修復(fù)菜單中，你也可以選擇

僅忽略此文件中的這個(gè)警告

忽略此項(xiàng)目中的這個(gè)警告

在此期間忽略此警告。

通過(guò)添加注解或?qū)傩院雎源藦V告， 此處有解釋。

(如果你在 quickfix 列表找不到 lint 的修復(fù)操作，請(qǐng)參閱 已知 Bug 章節(jié))

這些選擇都存儲(chǔ)項(xiàng)目里名為lint.xml的文件中，可以通過(guò)命令行工具讀取。因此，您可以在 UI 中忽略警告，并在你的源項(xiàng)目關(guān)聯(lián)的lint.xml文件中進(jìn)行記錄，其他運(yùn)行著的lint將不會(huì)看到你已經(jīng)忽略的警告(大概是因?yàn)橐呀?jīng)手動(dòng)驗(yàn)證了)。

選項(xiàng)

要編輯用于所有項(xiàng)目備用選項(xiàng)的 lint 全局選項(xiàng)，可以調(diào)用正常的 Eclipse 選項(xiàng)對(duì)話框，并選擇 Android > Lint Options：

如果你選擇了一個(gè)問(wèn)題，您可以在右下角的下拉列表中編輯其嚴(yán)重程度。這使您可以把某些問(wèn)題指定為 Error(即會(huì)在啟用了靠近頂部的對(duì)話框中的選項(xiàng)的情況下中止導(dǎo)出 APK)。

要完全關(guān)閉問(wèn)題檢查，請(qǐng)選擇“Ignore”作為嚴(yán)重程度。

請(qǐng)注意此操作不會(huì)編輯每個(gè)項(xiàng)目的 lint 設(shè)置

。打開(kāi)項(xiàng)目設(shè)置對(duì)話框 (右擊該項(xiàng)目)，你將在這里找到 Android Lint 的屬性頁(yè)。在選項(xiàng)對(duì)話框中手動(dòng)嚴(yán)重性編輯也會(huì)與取消顯示的錯(cuò)誤一起被記錄在lint.xml文件中，所以您的團(tuán)隊(duì)中的其他人將會(huì)獲得你對(duì)這個(gè)項(xiàng)目編輯的相同的嚴(yán)重性設(shè)置。 子頁(yè) (2)： 取消 Lint 警告的顯示(Suppressing Lint Warnings) 編寫一個(gè) Lint 檢查(Writing a Lint Check)