• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# UIExtension Error Codes
2
3> **NOTE**
4>
5> This topic describes only module-specific error codes. For details about universal error codes, see [Universal Error Codes](../errorcode-universal.md).
6
7## 1011 Ability Startup Failure
8
9**Error Message**
10
11Failed to start the UIExtension ability.
12
13**Description**
14
15This error code is reported when the UIExtension ability fails to start.
16
17**Possible Causes**
18
191. The configuration of the **Want** parameter is incorrect.
202. There is a type mismatch.
213. The provider application is not installed.
22
23**Solution**
24
25Verify the configuration of the **Want** parameter and the types, and ensure the application is installed.
26
27## 1012 Failed to Switch the Ability to the Background
28
29**Error Message**
30
31Failed to switch the UIExtension ability to the background.
32
33**Description**
34
35This error code is reported when the UIExtension ability fails to be moved to the background.
36
37**Possible Causes**
38
39Specific analysis is required based on AMS logs.
40
41**Solution**
42
43Analyze the AMS logs to troubleshoot.
44
45## 1013 Ability Termination Failure
46
47**Error Message**
48
49Failed to destroy the UIExtension ability.
50
51**Description**
52
53This error code is reported when the UIExtension ability fails to be terminated.
54
55**Possible Causes**
56
57Specific analysis is required based on AMS logs.
58
59**Solution**
60
61Analyze the AMS logs to troubleshoot.
62
63## 100011 No Synchronous Callback Registered
64
65**Error Message**
66
67No callback has been registered to respond to this request.
68
69**Description**
70
71This error code is reported when the UIExtension ability has not registered a synchronous callback.
72
73**Possible Causes**
74
75The component using the ability calls the **sendSync** API to send data to the launched ability before the ability registers a synchronous callback listener.
76
77**Solution**
78
791. Register a synchronous callback listener in the UIExtension ability.
802. Calls the **sendSync** API from the component using the ability to send data to the launched ability.
81
82## 100012 Data Transfer Failure
83
84**Error Message**
85
86Transferring data failed.
87
88**Description**
89
90This error code is reported when the data transfer fails.
91
92**Possible Causes**
93
94Specific analysis is required based on AMS logs.
95
96**Solution**
97
98Analyze the AMS logs to troubleshoot.
99
100## 100013 Nesting Not Allowed
101
102**Error Message**
103
104Cascading UIExtension components is not allowed.
105
106**Description**
107
108This error code is reported when illegal nesting of UIExtension components is detected.
109
110**Possible Causes**
111
112There might be nesting between UIExtension components.
113
114**Solution**
115
116Review UIExtension component specifications and avoid component nesting in special scenarios.
117
118## 100014 Ability Exit Error
119
120**Error Message**
121
122The UIExtension ability exited unexpectedly.
123
124**Description**
125
126This error code is reported when the UIExtension ability exits abnormally.
127
128**Possible Causes**
129
130Specific analysis is required based on AMS logs.
131
132**Solution**
133
134Analyze the AMS logs to troubleshoot.
135
136## 100015 Lifecycle Timeout
137
138**Error Message**
139
140The lifecycle of the UIExtension ability has timed out.
141
142**Description**
143
144This error code is reported when the lifecycle of the UIExtension ability times out.
145
146**Possible Causes**
147
148Specific analysis is required based on AMS logs.
149
150**Solution**
151
152Analyze the AMS logs to troubleshoot.
153
154## 100016 Key Event Processing Timeout
155
156**Error Message**
157
158Key event processing by the UIExtension ability has timed out.
159
160**Description**
161
162This error code is reported when the UIExtension ability takes too long to process a key event.
163
164**Possible Causes**
165
166Specific analysis is required based on AMS logs.
167
168**Solution**
169
170Analyze the AMS logs to troubleshoot.
171
172## 100018 Ability Startup Failure (with the onTerminated Callback)
173
174**Error Message**
175
176Failed to start the UIExtension ability.
177
178**Description**
179
180This error code is reported when the UIExtension ability fails to start in a scenario where the **onTerminated** callback is set.
181
182**Possible Causes**
183
1841. The configuration of the **Want** parameter is incorrect.
1852. There is a type mismatch.
1863. The provider application is not installed.
187
188**Solution**
189
190Verify the configuration of the **Want** parameter and the types, and ensure the application is installed.
191
192## 100019 Failed to Switch the Ability to the Background (with the onTerminated Callback)
193
194**Error Message**
195
196Failed to switch the UIExtension ability to the background.
197
198**Description**
199
200This error code is reported when the UIExtension ability fails to be moved to the background in a scenario where the **onTerminated** callback is set.
201
202**Possible Causes**
203
204Specific analysis is required based on AMS logs.
205
206**Solution**
207
208Analyze the AMS logs to troubleshoot.
209
210## 100020 Ability Termination Failure (with the onTerminated Callback)
211
212**Error Message**
213
214Failed to destroy the UIExtension ability.
215
216**Description**
217
218This error code is reported when the UIExtension ability fails to be terminated in a scenario where the **onTerminated** callback is set.
219
220**Possible Causes**
221
222Specific analysis is required based on AMS logs.
223
224**Solution**
225
226Analyze the AMS logs to troubleshoot.
227
228## 100021 Transparent Node Detected
229
230**Error Message**
231
232Transparent node is detected in the UIExtension ability.
233
234**Description**
235
236This error code is reported when a transparent node is detected in the UIExtension ability.
237
238**Possible Causes**
239
240A transparent node is detected in the UIExtension ability, which may cause blocking.
241
242**Solution**
243
244Identify and remove transparent nodes.
245