Oprócz tworzenia testów aby upewnić się, że aplikacja spełnia wymagania dotyczące funkcjonalności, Ważne jest, by uruchomić kod za pomocą narzędzia Lint, aby mieć pewność, że nie zawiera on żadnych . Narzędzie Lint pomaga znaleźć źle uporządkowany kod, który może mieć wpływ niezawodności i wydajności aplikacji na Androida oraz utrudniają zarządzanie kodem. Zdecydowanie zalecamy poprawienie wszystkich błędów wykrytych przez lint przed opublikowaniem aplikacji.
Na przykład jeśli pliki zasobów XML zawierają nieużywane przestrzenie nazw, zajmują one miejsce i wymagają niepotrzebne przetwarzanie. inne problemy strukturalne, takie jak użycie wycofanych elementów lub wywołania interfejsu API; które nie są obsługiwane przez docelowe wersje interfejsu API, mogą spowodować nieprawidłowe działanie kodu. Lint pomoże Ci rozwiązać te problemy.
Aby poprawić skuteczność lintowania, możesz też Dodaj adnotacje do kodu.
Omówienie
W Android Studio dostępne jest narzędzie do skanowania kodu o nazwie lint. które pomogą Ci zidentyfikować i rozwiązać problemy z jakością strukturalną kodu bez konieczności uruchamiania aplikacji czy pisania elementów testowych. Każdy problem wykryty przez narzędzie jest zgłaszane wraz z opisem i informacją o wadze, dzięki czemu możesz nadać niezbędne ulepszenia. Możesz też zmniejszyć wagę problemu, ignoruj problemy, które nie mają związku z Twoim projektem, lub podnieś wagę problemu do i wyróżniać konkretne problemy.
Narzędzie Lint sprawdza pliki źródłowe projektu Androida pod kątem potencjalnych błędów optymalizacja pod kątem poprawności, bezpieczeństwa, wydajności, łatwości obsługi, ułatwienia dostępu i internacjonalizacji. Jeśli korzystasz z Android Studio, skonfigurowane inspekcje lint i IDE są uruchamiane podczas tworzenia aplikacji; Pamiętaj jednak: możesz przeprowadzić inspekcję ręcznie lub uruchom lint z poziomu wiersza poleceń, zgodnie z opisem na tej stronie.
Wbudowane narzędzie Lint sprawdza kod, gdy go używasz Android Studio. Ostrzeżenia i błędy możesz wyświetlić na 2 sposoby:
- Jako tekst w wyskakującym okienku w oknie edytora. Gdy Lint znajdzie problem, zaznacza je. problematycznego kodu zaznaczonego na żółto. W poważniejszych przypadkach kod jest podkreślany na czerwono.
- W oknie Inspection Results (Wyniki inspekcji) po kliknięciu Kod > Sprawdź kod.
Uwaga: jeśli kod skompilujesz w Android Studio, dodatkowe Przeprowadzanie kontroli kodu IntelliJ w celu usprawnienia kodu weryfikacji.
Rysunek 1 pokazuje, jak narzędzie Lint przetwarza pliki źródłowe aplikacji.
- Pliki źródłowe aplikacji
- Pliki źródłowe składają się z plików tworzących projekt na Androida, w tym Kotlin, Javy Pliki XML, ikony i pliki konfiguracji ProGuard.
- Plik
lint.xml - Plik konfiguracji, który umożliwia określenie dowolnej kontroli lintowania wykluczać i dostosowywać poziomy ważności problemów.
- Narzędzie Linter
- Narzędzie do skanowania statycznego kodu, które możesz uruchomić w projekcie Androida z poziomu w wierszu poleceń lub w interfejsie Android Studio. Linter pozwala wykryć problemy z kodem strukturalnym, które mogą mieć wpływ na jakość i wydajność Aplikacja na Androida. .
- Wyniki sprawdzania lintowania
- Wyniki testu lint możesz wyświetlać w konsoli lub w wynikach inspekcji.
w Android Studio. Uruchomienie polecenia
lintz poziomu wiersza poleceń spowoduje, że wyniki będą następujące: zapisano w folderzebuild/. Więcej informacji można znaleźć w sekcji na temat ręcznie przeprowadzając kontrole.
Uruchamianie lint z wiersza poleceń
Jeśli korzystasz z Android Studio lub Gradle, użyj otoki Gradle, aby wywołać w projekcie zadanie lint przez
wpisz jedno z tych poleceń z katalogu głównego projektu:
- Windows:
gradlew lint
- W systemie Linux lub macOS:
./gradlew lint
Zostaną wyświetlone dane wyjściowe podobne do tych:
> Task :app:lintDebug Wrote HTML report to file:<path-to-project>/app/build/reports/lint-results-debug.html
Po zakończeniu sprawdzania narzędzie lint udostępnia ścieżki do plików XML i HTML. wersji raportu Lint. Następnie przejdź do raportu HTML i otwórz go w przeglądarce jak widać na rysunku 2.
Jeśli Twój projekt zawiera kompilację
wersji, Lint sprawdza tylko wariant domyślny. Jeśli chcesz uruchomić lint na innym urządzeniu,
wariantu, musisz napisać nazwę wariantu wielką literą i dodać do niej przedrostek lint.
./gradlew lintRelease
Aby dowiedzieć się więcej o bieganiu Zadania Gradle z poziomu wiersza poleceń znajdziesz w artykule Tworzenie aplikacji z poziomu wiersza poleceń.
Uruchom Lint za pomocą oddzielnego narzędzia
Jeśli nie używasz Android Studio ani Gradle,
zainstalować narzędzia wiersza poleceń pakietu Android SDK,
aby użyć oddzielnego narzędzia Lint. Znajdź narzędzie Lint
o android_sdk/cmdline-tools/version/bin/lint.
Uwaga: jeśli spróbujesz uruchomić samodzielne narzędzie w projekcie Gradle, otrzymasz
błąd. Do uruchamiania linta w projekcie Gradle należy zawsze używać narzędzia gradle lint (w systemie Windows) lub ./gradlew
lint (w systemie macOS lub Linux).
Aby uruchomić lint na liście plików w katalogu projektu, użyj tego polecenia:
lint [flags] <project directory>
Możesz na przykład uruchomić następujące polecenie, aby przeskanować pliki w katalogu
myproject i jego podkatalogi. Identyfikator problemu: MissingPrefix
informuje lint, aby skanować tylko w poszukiwaniu atrybutów XML, w których brakuje prefiksu przestrzeni nazw Androida.
lint --check MissingPrefix myproject
Aby zobaczyć pełną listę flag i argumentów wiersza poleceń obsługiwanych przez to narzędzie, użyj to polecenie:
lint --help
Poniższy przykład pokazuje dane wyjściowe konsoli po uruchomieniu polecenia lint względem projekt o nazwie Trzęsienie ziemi:
$ lint Earthquake Scanning Earthquake: ............................................................................................................................... Scanning Earthquake (Phase 2): ....... AndroidManifest.xml:23: Warning: <uses-sdk> tag appears after <application> tag [ManifestOrder] <uses-sdk android:minSdkVersion="7" /> ^ AndroidManifest.xml:23: Warning: <uses-sdk> tag should specify a target API level (the highest verified version; when running on later versions, compatibility behaviors may be enabled) with android:targetSdkVersion="?" [UsesMinSdkAttributes] <uses-sdk android:minSdkVersion="7" /> ^ res/layout/preferences.xml: Warning: The resource R.layout.preferences appears to be unused [UnusedResources] res: Warning: Missing density variation folders in res: drawable-xhdpi [IconMissingDensityFolder] 0 errors, 4 warnings
W przykładowych danych wyjściowych zobaczysz 4 ostrzeżenia i brak błędów.
2 ostrzeżenia odnoszą się do pliku AndroidManifest.xml projektu:
ManifestOrderUsesMinSdkAttributes
Preferences.xml: UnusedResources.
Jedno ostrzeżenie dotyczy katalogu res:
IconMissingDensityFolder
Konfigurowanie lint do pomijania ostrzeżeń
Domyślnie po uruchomieniu skanowania narzędzie sprawdza, czy nie występują w nim wszystkie problemy. Możesz też ograniczyć problemy, które lint może sprawdzać, i przypisać wagę poziomów problemów. Możesz na przykład powstrzymać sprawdzanie lintowania pod kątem konkretnych problemów, które nie mają związku z Twoim projektem. Możesz skonfigurować lint, aby zgłaszać niekrytyczne problemy w o niższym poziomie ważności.
Poziomy ważności:
enabledisablelubignoreinformationalwarningerrorfatal
Sprawdzanie lintowania można skonfigurować na różnych poziomach:
- Globalnie (cały projekt)
- Moduł projektu
- Moduł produkcyjny
- Przetestuj moduł
- Otwórz pliki
- Hierarchia klas
- Zakresy systemu kontroli wersji (VCS)
Konfigurowanie pliku lint
Preferencje dotyczące sprawdzania lint możesz określić w pliku lint.xml. Jeśli
podczas ręcznego tworzenia tego pliku, umieść go w katalogu głównym swojego projektu na Androida.
Plik lint.xml składa się z tagu nadrzędnego <lint>, który
zawiera co najmniej jeden element podrzędny <issue>. Lint określa unikalny
Wartość atrybutu id dla każdej wartości w kolumnie <issue>:
<?xml version="1.0" encoding="UTF-8"?> <lint> <!-- list of issues to configure --> </lint>
Aby zmienić poziom ważności problemu lub wyłączyć sprawdzanie lintowania problemu,
ustaw atrybut ważności w tagu <issue>.
Wskazówka: pełną listę problemów obsługiwanych przez Litt i odpowiadających im problemów
identyfikatory problemów, uruchom polecenie lint --list.
Przykładowy plik lint.xml
Ten przykład pokazuje zawartość pliku lint.xml:
<?xml version="1.0" encoding="UTF-8"?> <lint> <!-- Disable the IconMissingDensityFolder check in this project --> <issue id="IconMissingDensityFolder" severity="ignore" /> <!-- Ignore the ObsoleteLayoutParam issue in the specified files --> <issue id="ObsoleteLayoutParam"> <ignore path="res/layout/activation.xml" /> <ignore path="res/layout-xlarge/activation.xml" /> </issue> <!-- Ignore the UselessLeaf issue in the specified file --> <issue id="UselessLeaf"> <ignore path="res/layout/main.xml" /> </issue> <!-- Change the severity of hardcoded strings to "error" --> <issue id="HardcodedText" severity="error" /> </lint>
Ten przykład pokazuje, jak są zgłaszane różne typy problemów.
IconMissingDensityFolder
sprawdzanie jest całkowicie wyłączone, a sprawdzanie ObsoleteLayoutParam jest wyłączone tylko
w plikach wymienionych w załączonych deklaracji <ignore ... />.
Skonfiguruj sprawdzanie lint dla plików źródłowych Kotlin, Java i XML
Możesz wyłączyć sprawdzanie lint w plikach źródłowych Kotlin, Java i XML w oknie Ustawienia:
- Wybierz Plik > Ustawienia (w Windows) lub Android Studio > Ustawienia (w systemach macOS i Linux).
- Wybierz Edytor > Inspekcje.
- Aby wyłączyć tę funkcję, odznacz odpowiedni plik źródłowy.
Możesz je ustawić dla IDE lub dla poszczególnych projektów przez wybierając odpowiedni profil.
Skonfiguruj sprawdzanie lint w Javie lub Kotlinie
Aby wyłączyć sprawdzanie lintowania w przypadku klasy lub metody w projekcie na Androida:
dodać do tego kodu adnotację @SuppressLint.
Poniższy przykład pokazuje, jak wyłączyć sprawdzanie lint dla aplikacji NewApi
w metodzie onCreate. Narzędzie Lint nadal sprawdza, czy
NewApi problem w innych metodach tej klasy.
Kotlin
@SuppressLint("NewApi") override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.main)
Java
@SuppressLint("NewApi") @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.main);
To samo można zrobić na każdym elemencie kompozycyjnym. Poniższy fragment kodu pokazuje, jak
sprawdza NewApi na dowolnym elemencie kompozycyjnym.
Kotlin
@SuppressLint("NewApi") @Composable fun MyComposable{ ... }
Poniższy przykład pokazuje, jak wyłączyć sprawdzanie lint na urządzeniu ParserError
problem w klasie FeedProvider:
Kotlin
@SuppressLint("ParserError") class FeedProvider : ContentProvider() {
Java
@SuppressLint("ParserError") public class FeedProvider extends ContentProvider {
Aby pominąć sprawdzanie wszystkich błędów w pliku, użyj słowa kluczowego all:
Kotlin
@SuppressLint("all")
Java
@SuppressLint("all")
Tej samej adnotacji możesz używać do pomijania kontroli lintowania w dowolnej funkcji kompozycyjnej.
Skonfiguruj sprawdzanie lint w pliku XML
Użyj atrybutu tools:ignore, aby wyłączyć sprawdzanie lint dla określonych
plików XML. Umieść poniższą wartość przestrzeni nazw w pliku lint.xml
tak aby narzędzie lint rozpoznało atrybut:
namespace xmlns:tools="http://schemas.android.com/tools"
Poniższy przykład pokazuje, jak wyłączyć sprawdzanie lint dla
Problem z UnusedResources w elemencie <LinearLayout> kodu XML
pliku układu. Atrybut ignore jest dziedziczony przez elementy podrzędne elementu nadrzędnego.
w którym zadeklarowano atrybut. W tym przykładzie kontrola lintowania jest również wyłączona dla
element podrzędny <TextView>:
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://schemas.android.com/tools" tools:ignore="UnusedResources" > <TextView android:text="@string/auto_update_prompt" /> </LinearLayout>
Aby wyłączyć więcej niż 1 problem, podaj listę rozdzielonych przecinkami problemy, które chcesz wyłączyć. Dla: przykład:
tools:ignore="NewApi,StringFormatInvalid"
Aby pominąć sprawdzanie pod kątem wszystkich problemów z lintem w elemencie XML, użyj funkcji all
słowo kluczowe:
tools:ignore="all"
Konfigurowanie opcji lintowania przy użyciu Gradle
Wtyczka Androida do Gradle pozwala skonfigurować określone opcje lintowania,
np. które testy należy przeprowadzić lub zignorować, korzystając z
Blok lint{} na poziomie modułu
build.gradle.
Ten fragment kodu zawiera niektóre z właściwości, które możesz skonfigurować:
Kotlin
android { ... lint { // Turns off checks for the issue IDs you specify. disable += "TypographyFractions" + "TypographyQuotes" // Turns on checks for the issue IDs you specify. These checks are in // addition to the default lint checks. enable += "RtlHardcoded" + "RtlCompat" + "RtlEnabled" // To enable checks for only a subset of issue IDs and ignore all others, // list the issue IDs with the 'check' property instead. This property overrides // any issue IDs you enable or disable using the properties above. checkOnly += "NewApi" + "InlinedApi" // If set to true, turns off analysis progress reporting by lint. quiet = true // If set to true (default), stops the build if errors are found. abortOnError = false // If set to true, lint only reports errors. ignoreWarnings = true // If set to true, lint also checks all dependencies as part of its analysis. // Recommended for projects consisting of an app with library dependencies. checkDependencies = true } } ...
Odlotowe
android { ... lint { // Turns off checks for the issue IDs you specify. disable 'TypographyFractions','TypographyQuotes' // Turns on checks for the issue IDs you specify. These checks are in // addition to the default lint checks. enable 'RtlHardcoded','RtlCompat', 'RtlEnabled' // To enable checks for only a subset of issue IDs and ignore all others, // list the issue IDs with the 'check' property instead. This property overrides // any issue IDs you enable or disable using the properties above. checkOnly 'NewApi', 'InlinedApi' // If set to true, turns off analysis progress reporting by lint. quiet true // If set to true (default), stops the build if errors are found. abortOnError false // If set to true, lint only reports errors. ignoreWarnings true // If set to true, lint also checks all dependencies as part of its analysis. // Recommended for projects consisting of an app with library dependencies. checkDependencies true } } ...
Wszystkie metody lintowania, które zastępują dany poziom ważności problemu, respektują
kolejność konfiguracji. Na przykład określenie problemu jako krytycznego w
finalizeDsl()
zastępuje jej wyłączenie w głównym DSL.
Utwórz punkt odniesienia dla ostrzeżeń
Możesz zrobić zrzut bieżącego zestawu ostrzeżeń w projekcie, a następnie użyć zrzutu jako punktu odniesienia przy kolejnych inspekcjach, aby zgłaszane były tylko nowe problemy. Zrzut bazowy pozwala zacząć używać lint do niepowodzenia kompilacji bez i rozwiązać je w pierwszej kolejności.
Aby utworzyć zrzut podstawowy, zmodyfikuj plik build.gradle projektu w ten sposób:
Kotlin
android { lint { baseline = file("lint-baseline.xml") } }
Odlotowe
android { lintOptions { baseline file("lint-baseline.xml") } }
Po dodaniu tego wiersza po raz pierwszy tworzony jest plik lint-baseline.xml, aby ustalić
od wartości bazowej. Od tej pory narzędzia odczytują plik tylko w celu określenia punktu odniesienia. Jeśli chcesz
, aby utworzyć nowy element bazowy, ręcznie usuń ten plik i uruchom lint ponownie, aby odtworzyć go.
Następnie uruchom lint z IDE, wybierając Kod > Sprawdź kod lub z poziomu wiersza poleceń
w następujący sposób. W danych wyjściowych zostanie podana lokalizacja pliku lint-baseline.xml.
lokalizacja pliku konfiguracji może być inna niż widoczna tutaj:
$ ./gradlew lintDebug -Dlint.baselines.continue=true ... Wrote XML report to file:///app/lint-baseline.xml Created baseline file /app/lint-baseline.xml
Uruchomienie polecenia lint powoduje zarejestrowanie wszystkich
bieżące problemy w pliku lint-baseline.xml. Zbiór bieżących problemów to
jest to punkt odniesienia. Informacje na ten temat znajdziesz tutaj: lint-baseline.xml
do kontroli wersji, jeśli chcesz udostępnić go innym.
Dostosuj element bazowy
Jeśli do punktu odniesienia chcesz dodać tylko niektóre typy problemów, podaj
problemy, które możesz dodać, edytując plik build.gradle projektu w ten sposób:
Kotlin
android { lint { checkOnly += "NewApi" + "HandlerLeak" baseline = file("lint-baseline.xml") } }
Odlotowe
android { lintOptions { checkOnly 'NewApi', 'HandlerLeak' baseline file("lint-baseline.xml") } }
Jeśli po utworzeniu bazy kodu dodasz do bazy kodu nowe ostrzeżenia punkty odniesienia, tylko listy lintowania o nowych błędach.
Ostrzeżenie dotyczące punktu odniesienia
Jeśli będzie obowiązywać punkt odniesienia, pojawi się ostrzeżenie informujące, że co najmniej problemy zostały odfiltrowane, ponieważ znajdują się w grupie bazowej. Ten informuje, że został przez Ciebie skonfigurowany punkt odniesienia i musisz rozwiązać wszystkie problemy na stronie w pewnym momencie.
To ostrzeżenie zawiera też informacje o problemach, które nie są już zgłaszane. Ta informacja pozwala czy udało się rozwiązać problemy, dzięki czemu można opcjonalnie odtworzyć punkt odniesienia, nie wykryto błędu.
Uwaga: Punkty podstawowe są włączone, gdy przeprowadzasz inspekcje w trybie wsadowym w IDE, ale są ignorowane dla kontroli w edytorze, które są przeprowadzane w tle, gdy edytujesz plik. Dzieje się tak, ponieważ wartości bazowe są stosowane w przypadkach, gdy w bazie kodu jest duża liczba ostrzeżeń, Chcesz rozwiązać problemy lokalnie po dotknięciu kodu.
Ręczne przeprowadzanie inspekcji
Aby ręcznie uruchomić skonfigurowane kontrole lint i inne inspekcje IDE, wybierz Kod > Sprawdź kod. Wyniki kontroli pojawią się w Okno Wyniki inspekcji.
Ustaw zakres i profil inspekcji
Wybierz pliki do analizy (zakres inspekcji) i i inspekcje, które chcesz przeprowadzić (profil inspekcji), wykonaj te czynności:
- W widoku Androida otwórz projekt i wybierz projekt, folder lub który chcesz przeanalizować.
- Na pasku menu wybierz Kod > Sprawdź kod.
W oknie Określ zakres inspekcji sprawdź ustawienia.
Rysunek 3. Sprawdź ustawienia zakresu inspekcji. Opcje widoczne w oknie Określ zakres inspekcji różnią się w zależności od wybranego projektu, folderu lub pliku:
- Gdy wybierzesz jeden projekt, plik lub katalog, Określanie zakresu inspekcji zawiera ścieżkę do projektu, pliku lub wybranego katalogu.
- Jeśli wybierzesz więcej niż 1 projekt, plik lub katalog, opcja Określ inspekcję Okno Zakres z wybraną opcją Wybrane pliki.
Aby zmienić elementy do sprawdzenia, wybierz jeden z pozostałych przycisków opcji. Zobacz Okno dialogowe Określ zakres inspekcji, aby wyświetlić opis wszystkich możliwe pola w oknie Określ zakres inspekcji.
- W sekcji Profil inspekcji wybierz profil, którego chcesz użyć.
Aby przeprowadzić kontrolę, kliknij OK.
Ilustracja 4 przedstawia Lint i inną kontrolę IDE wyniku uruchomienia Zbadaj kod:
Rysunek 4. Wyniki inspekcji. Wybierz problem aby sprawdzić rozdzielczość. -
W panelu Wyniki inspekcji wyświetl wyniki inspekcji, rozwijając i wybierając kategorii, typów i problemów.
W panelu Raport inspekcji pojawi się raport z przeglądu dotyczący kategorii błędu. lub problem wybrany w panelu Wyniki inspekcji. Zobaczysz też jego nazwę lokalizację błędu. W razie potrzeby raport z przeglądu zawiera inne informacje. np. streszczenie problemu.
W widoku drzewa w panelu Wyniki inspekcji kliknij prawym przyciskiem kategorię, typ lub problem, aby wyświetlacz w menu kontekstowym.
W zależności od kontekstu możesz:
- Przejdź do źródła.
- Wyklucz i uwzględnij wybrane elementy.
- Unikaj problemów.
- Zmień ustawienia.
- Zarządzaj alertami dotyczącymi inspekcji.
- Ponownie uruchom inspekcję.
Opisy przycisków paska narzędzi, elementów menu kontekstowego i inspekcji pól raportu, patrz Okno narzędzia z wynikami inspekcji.
Używanie zakresu niestandardowego
Użyj jednego z zakresów niestandardowych dostępnych w Android Studio w ten sposób:
- W oknie Określ zakres inspekcji wybierz Zakres niestandardowy.
Kliknij listę Zakres niestandardowy, aby wyświetlić opcje:
Rysunek 5. Wybierz, który zakres niestandardowy chcesz zastosować - Wszystkie miejsca:wszystkie pliki.
- Pliki projektu: wszystkie pliki w bieżącym projekcie.
- Pliki źródłowe projektu: tylko pliki źródłowe w bieżącym projekcie.
- Pliki produkcyjne projektu: tylko pliki produkcyjne w bieżącym projekcie.
- Pliki testowe projektu: tylko pliki testowe w bieżącym projekcie.
- Zarysowania i konsole: tylko pliki zawierające zdrapki i konsole otwarte w w bieżącym projekcie.
- Ostatnio wyświetlane pliki: tylko ostatnio wyświetlane pliki w bieżącym projekcie.
- Bieżący plik:zawiera tylko bieżący plik w bieżącym projekcie. Pojawia się, gdy masz wybrany plik lub folder.
- Wybrany katalog: tylko bieżący folder w bieżącym projekcie. Widoczne, gdy: zaznacz folder.
- Hierarchia zajęć: gdy wybierzesz tę opcję i klikniesz OK, pojawi się okno z wszystkich klas w bieżącym projekcie. W oknie dialogowym użyj pola Szukaj według nazwy. aby przefiltrować i wybrać zajęcia, sprawdzić. Jeśli nie filtrujesz listy klas, inspekcja kodu sprawdza wszystkie zajęcia.
Jeśli w projekcie masz skonfigurowany kod VCS, dostępne są też opcje ograniczenia wyszukiwania tylko tych zmodyfikowanych.
- Kliknij OK.
Tworzenie zakresu niestandardowego
Jeśli chcesz sprawdzić wybrane pliki i katalogi, których nie obejmuje żadna obecnie dostępnych zakresów niestandardowych możesz utworzyć:
- W oknie Określ zakres inspekcji wybierz Zakres niestandardowy.
Kliknij 3 kropki za listą Zakres niestandardowy.
Rysunek 6. Okno Określ zakres inspekcji. Pojawi się okno Zakresy.
Rysunek 7. Utwórz zakres niestandardowy. - Kliknij
w lewym górnym rogu okna, aby zdefiniować nowy zakres. - Na wyświetlonej liście Dodaj zakres wybierz Lokalny.
Do zadania Zbadaj kod używane są w projekcie zakresy lokalne i udostępnione. funkcji. Zakresu udostępnionego można też używać z innymi funkcjami projektu, które mają zakres . Na przykład: gdy klikniesz Edytuj ustawienia
, aby zmienić:
ustawienia Find Usages (Znajdź przypadki użycia). W wyświetlonym oknie zobaczysz pole Zakres, w którym
wybierz wspólny zakres.
Rysunek 8. Wybierz zakres wspólny z Okno Find Usages (Znajdź wykorzystanie). - Nadaj zakresowi nazwę i kliknij OK.
Panel po prawej stronie okna Zakresy zawiera opcje, które umożliwiają zdefiniowanie zakresu niestandardowego.
- Z listy wybierz Projekt.
Pojawi się lista dostępnych projektów.
Uwaga: zakres niestandardowy możesz utworzyć dla projektów lub pakietów. są takie same.
Rozwiń foldery projektu, wybierz, co chcesz dodać do zakresu niestandardowego, i kliknij czy uwzględnić, czy wykluczyć.
Rysunek 9. Zdefiniuj zakres niestandardowy. - Uwzględnij: uwzględnij ten folder i jego pliki, ale nie umieszczaj w nich żadnych podfolderów.
- Uwzględnij rekursywnie: uwzględnij ten folder i jego pliki oraz jego podfoldery i ich .
- Wyklucz: wyklucz ten folder i jego pliki, ale nie wykluczaj żadnego z jego podfolderów.
- Wyklucz rekursywnie: powoduje wykluczenie tego folderu i jego plików oraz jego podfolderów i ich .
Rysunek 10 pokazuje, że dołączony jest folder main i że pakiet java i res są uwzględniane cyklicznie. Niebieski oznacza folder częściowo uwzględniony, a zielony wskazuje foldery i pliki uwzględniane rekurencyjnie.
Rysunek 10. Przykładowy wzorzec zakresu niestandardowego. - Jeśli wybierzesz folder java i klikniesz Wyklucz rekursywnie, zielony przycisk z folderu java oraz wszystkich znajdujących się w nim folderów oraz plików zostaną usunięte wyróżnienia.
- Jeśli wybierzesz zaznaczony na zielono plik MainActivity.kt i kliknij Wyklucz. Kategoria MainActivity.kt nie jest już podświetlona na zielono, wszystkie pozostałe w folderze java pozostaną zielone.
- Kliknij OK. Zakres niestandardowy pojawi się u dołu listy.
Sprawdzanie i edytowanie profili inspekcji
W Android Studio dostępne są dostępne profile lint i inne, które są aktualizowane Przez Aktualizacje Androida. Możesz korzystać z tych profili w niezmienionej formie lub edytować ich nazwy, opisy, wagi oraz i zakresu. Możesz też aktywować i dezaktywować całe grupy profili lub poszczególne profile w grupie.
Aby uzyskać dostęp do ustawień Inspekcje:
- Wybierz Plik > Ustawienia. (w systemie Windows) lub Android Studio > Ustawienia (w systemach macOS i Linux).
- Wybierz Edytor > Inspekcje.
Wybierz listę Profil, by przełączać się między opcją Domyślny (Android Studio) lub Inspekcje Projektu domyślnego (aktywny projekt).
Więcej informacji znajdziesz na stronie IntelliJ Zarządzaj profilami.
Na liście Kontrole w panelu po lewej stronie wybierz kategorię profilu najwyższego poziomu lub rozwiń grupę i wybierz określony profil.
Po wybraniu kategorii profilu możesz edytować wszystkie kontrole w tej kategorii jako jedną kontrolę.
- Wybierz listę Pokaż działania schematu
, aby ją skopiować, zmienić nazwę lub dodać
do kontroli, eksportowania i importowania. - Gdy skończysz, kliknij OK.
W panelu Kontrole wyświetlana jest lista obsługiwanych inspekcji i ich tekstów reklamy.
