1+ < meta charset ="utf-8 ">
2+ (#) Only view groups can have children
3+
4+ !!! ERROR: Only view groups can have children
5+ This is an error.
6+
7+ Id
8+ : `ChildInNonViewGroup`
9+ Summary
10+ : Only view groups can have children
11+ Severity
12+ : Error
13+ Category
14+ : Correctness
15+ Platform
16+ : Android
17+ Vendor
18+ : Android Open Source Project
19+ Feedback
20+ : https://issuetracker.google.com/issues/new?component=192708
21+ Affects
22+ : Resource files
23+ Editing
24+ : This check runs on the fly in the IDE editor
25+ Implementation
26+ : [Source Code](https://cs.android.com/android-studio/platform/tools/base/+/mirror-goog-studio-main:lint/libs/lint-checks/src/main/java/com/android/tools/lint/checks/ChildInNonViewGroupDetector.kt)
27+ Tests
28+ : [Source Code](https://cs.android.com/android-studio/platform/tools/base/+/mirror-goog-studio-main:lint/libs/lint-tests/src/test/java/com/android/tools/lint/checks/ChildInNonViewGroupDetectorTest.kt)
29+ Copyright Year
30+ : 2011
31+
32+ Only classes inheriting from `ViewGroup` can have children.
33+
34+ (##) Example
35+
36+ Here is an example of lint warnings produced by this check:
37+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~text
38+ res/layout/wrong.xml:9:Error: A ImageView should have no children
39+ declared in XML [ChildInNonViewGroup]
40+ <TextView />
41+ --------
42+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
43+
44+ Here is the source file referenced above:
45+
46+ `res/layout/wrong.xml`:
47+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~xml linenumbers
48+ <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
49+ android:orientation="vertical"
50+ android:layout_width="match_parent"
51+ android:layout_height="match_parent">
52+
53+ <ImageView
54+ android:layout_width="wrap_content"
55+ android:layout_height="wrap_content">
56+ <TextView />
57+ </ImageView>
58+
59+ </LinearLayout>
60+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
61+
62+ You can also visit the
63+ [source code](https://cs.android.com/android-studio/platform/tools/base/+/mirror-goog-studio-main:lint/libs/lint-tests/src/test/java/com/android/tools/lint/checks/ChildInNonViewGroupDetectorTest.kt)
64+ for the unit tests for this check to see additional scenarios.
65+
66+ The above example was automatically extracted from the first unit test
67+ found for this lint check, `ChildInNonViewGroupDetector.test wrong nesting of TextView within ImageView`.
68+ To report a problem with this extracted sample, visit
69+ https://issuetracker.google.com/issues/new?component=192708.
70+
71+ (##) Suppressing
72+
73+ You can suppress false positives using one of the following mechanisms:
74+
75+ * Adding the suppression attribute
76+ `tools:ignore="ChildInNonViewGroup"` on the problematic XML element
77+ (or one of its enclosing elements). You may also need to add the
78+ following namespace declaration on the root element in the XML file
79+ if it's not already there:
80+ `xmlns:tools="http://schemas.android.com/tools"`.
81+
82+ * Using a special `lint.xml` file in the source tree which turns off
83+ the check in that folder and any sub folder. A simple file might look
84+ like this:
85+ ```xml
86+ <?xml version="1.0" encoding="UTF-8"?>
87+ <lint>
88+ <issue id="ChildInNonViewGroup" severity="ignore" />
89+ </lint>
90+ ```
91+ Instead of `ignore` you can also change the severity here, for
92+ example from `error` to `warning`. You can find additional
93+ documentation on how to filter issues by path, regular expression and
94+ so on
95+ [here](https://googlesamples.github.io/android-custom-lint-rules/usage/lintxml.md.html).
96+
97+ * In Gradle projects, using the DSL syntax to configure lint. For
98+ example, you can use something like
99+ ```gradle
100+ lintOptions {
101+ disable 'ChildInNonViewGroup'
102+ }
103+ ```
104+ In Android projects this should be nested inside an `android { }`
105+ block.
106+
107+ * For manual invocations of `lint`, using the `--ignore` flag:
108+ ```
109+ $ lint --ignore ChildInNonViewGroup ...`
110+ ```
111+
112+ * Last, but not least, using baselines, as discussed
113+ [here](https://googlesamples.github.io/android-custom-lint-rules/usage/baselines.md.html).
114+
115+ <!-- Markdeep: --> < style class ="fallback "> body {visibility : hidden;white-space : pre;font-family : monospace}</ style > < script src ="markdeep.min.js " charset ="utf-8 "> </ script > < script src ="https://morgan3d.github.io/markdeep/latest/markdeep.min.js " charset ="utf-8 "> </ script > < script > window . alreadyProcessedMarkdeep || ( document . body . style . visibility = "visible" ) </ script >
0 commit comments