forked from quarkusio/pt.quarkus.io
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathextension-faq.adoc.po
181 lines (144 loc) · 7.86 KB
/
extension-faq.adoc.po
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
msgid ""
msgstr ""
"Language: pt_BR\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"X-Generator: jekyll-l10n\n"
#: _guides/extension-faq.adoc
msgid "Frequently asked questions about writing extensions"
msgstr ""
#: _guides/extension-faq.adoc
msgid "Should you write an extension?"
msgstr ""
#: _guides/extension-faq.adoc
msgid "Why would I want to write an extension?"
msgstr ""
#: _guides/extension-faq.adoc
msgid ""
"See the xref:writing-extensions.adoc#extension-philosophy[extension philosophy].\n"
"The xref:extension-maturity-matrix.adoc[extension maturity matrix] shows the kinds of capabilities extensions can offer.\n"
"Another useful thing extensions can do is bundle other extensions.\n"
"Have a look at the link:https://quarkus.io/extensions/io.quarkiverse.microprofile/quarkus-microprofile/[Quarkus MicroProfile extension] for an example of aggregator extensions."
msgstr ""
#: _guides/extension-faq.adoc
msgid "Are there cases an extension isn't necessary?"
msgstr ""
#: _guides/extension-faq.adoc
msgid ""
"Not every problem needs an extension!\n"
" If you're just bundling up external libraries (that aren't already extensions) and making minor adjustments, you might not need an extension.\n"
" For example, plain libraries can create new configuration elements and register classes with Jandex (this link:https://www.loicmathieu.fr/wordpress/en/informatique/quarkus-tip-comment-ne-pas-creer-une-extension-quarkus/[blog shows how])."
msgstr ""
#: _guides/extension-faq.adoc
msgid "How do I know what kind of capabilities I might want to include in an extension?"
msgstr ""
#: _guides/extension-faq.adoc
msgid "Have a look at the xref:extension-maturity-matrix.adoc[extension maturity matrix]."
msgstr ""
#: _guides/extension-faq.adoc
msgid "Bytecode transformation"
msgstr ""
#: _guides/extension-faq.adoc
msgid "How can I change the code of things on the classpath?"
msgstr ""
#: _guides/extension-faq.adoc
msgid ""
"A `BytecodeTransformerBuildItem` can be used to manipulate bytecode.\n"
"For example, see this link:https://quarkus.io/blog/solving-problems-with-extensions/[blog about removed problematic bridge methods from a dependency]."
msgstr ""
#: _guides/extension-faq.adoc
#, fuzzy
msgid "CDI"
msgstr "CDI"
#: _guides/extension-faq.adoc
msgid "I'm working with CDI, and I don't know how to ..."
msgstr ""
#: _guides/extension-faq.adoc
msgid "The xref:cdi-integration.adoc[CDI integration guide] presents solutions to a number of CDI-related use cases for extension authors."
msgstr ""
#: _guides/extension-faq.adoc
msgid "I have transformed a user class to add an injected field, but CDI isn't working"
msgstr ""
#: _guides/extension-faq.adoc
msgid ""
"What happens if an extension transforms a user class using `BytecodeTransformerBuildItem`, and replaces `@jakarta.annotation.Resource` with `@jakarta.inject.Inject`? The field will not be injected by Arc.\n"
"Debugging will show the transformed class being loaded in the app, but it looks like Arc doesn't see the new code."
msgstr ""
#: _guides/extension-faq.adoc
msgid ""
"Arc-related transformations should generally be done with link:https://github.com/quarkusio/quarkus/blob/main/extensions/arc/deployment/src/main/java/io/quarkus/arc/deployment/AnnotationsTransformerBuildItem.java[AnnotationsTransformerBuildItem].\n"
"The reason is that _all_ Quarkus's bytecode transformations are done after Jandex indexing. This means changes are never reflected back in Jandex."
msgstr ""
#: _guides/extension-faq.adoc
msgid ""
"Most extensions use Jandex as a source of truth to find out what to do. Those extensions won't see new/modified endpoints in the bytecode itself.\n"
"The solution to this limitation is annotation transformers. You should also be aware that while Arc and Quarkus REST honour annotation transformers, not all extensions do."
msgstr ""
#: _guides/extension-faq.adoc
msgid "Something in my classpath has @Inject annotations, which are confusing CDI. How can I fix that?"
msgstr ""
#: _guides/extension-faq.adoc
msgid "You will need to implement an `AnnotationsTransformer` and strip out out the problematic injection sites. (Remember, if the use case involves CDI, it needs to be an `AnnotationsTransformer`, not a BytecodeTransformer`.) See link:https://quarkus.io/blog/solving-problems-with-extensions-2/[this blog] about on using an `AnnotationsTransformer` extension to clean non `@Inject` annotations from the Airline library so that it can be used in CDI-enabled runtimes."
msgstr ""
#: _guides/extension-faq.adoc
msgid "Cross-cutting concerns"
msgstr ""
#: _guides/extension-faq.adoc
msgid "How can I redirect application logging to an external service?"
msgstr ""
#: _guides/extension-faq.adoc
msgid "A `LogHandlerBuildItem` is a convenient way to redirect application logs. See this link:https://quarkus.io/blog/quarkus-aws-cloudwatch_extension/[worked example of an extension which directs output to AWS CloudWatch]."
msgstr ""
#: _guides/extension-faq.adoc
msgid "Build and hosting infrastructure for extensions"
msgstr ""
#: _guides/extension-faq.adoc
msgid "Can I use Gradle to build my extension?"
msgstr ""
#: _guides/extension-faq.adoc
msgid ""
"Yes, but it's not the most typical pattern.\n"
"See the xref:building-my-first-extension.adoc#gradle-setup[Building Your First Extension Guide] for instructions on setting up a Gradle extension. Have a look at the link:https://quarkus.io/extensions/org.jobrunr/quarkus-jobrunr/[JobRunr extension] for an example implementation."
msgstr ""
#: _guides/extension-faq.adoc
msgid "If I want my extension to be in code.quarkus.io, does it have to be in the Quarkiverse GitHub org?"
msgstr ""
#: _guides/extension-faq.adoc
msgid ""
"Registering an extension in the catalog is independent from where the source code is.\n"
"The link:https://hub.quarkiverse.io[quarkiverse repository] has some shortcuts to make releasing and testing extensions easier, but any extension can link:https://hub.quarkiverse.io/checklistfornewprojects/#make-your-extension-available-in-the-tooling[register into the catalog]."
msgstr ""
#: _guides/extension-faq.adoc
msgid "My extension isn't showing up on extensions.quarkus.io"
msgstr ""
#: _guides/extension-faq.adoc
msgid ""
"Every extension in the link:https://github.com/quarkusio/quarkus-extension-catalog/tree/main/extensions[extension catalog] should appear in http://code.quarkus.io, http://extensions.quarkus.io, and the command line tools.\n"
"The web pages at http://extensions.quarkus.io are refreshed a few times a delay, so there may be a delay in new extensions showing up there.\n"
"To debug a missing extension, first:"
msgstr ""
#: _guides/extension-faq.adoc
msgid "Check your extension is present in link:https://central.sonatype.com/[Maven Central]"
msgstr ""
#: _guides/extension-faq.adoc
msgid "Check the extension is included the link:https://github.com/quarkusio/quarkus-extension-catalog/tree/main/extensions[extensions catalog list] (it only needs to be included once, and future versions will be automatically detected)"
msgstr ""
#: _guides/extension-faq.adoc
msgid "Check if the extension is listed in the http://https://registry.quarkus.io/q/swagger-ui/#/Client/get_client_extensions_all[Quarkus registry] list of all known extensions"
msgstr ""
#: _guides/extension-faq.adoc
msgid "Check if there has been a green link:https://github.com/quarkusio/extensions/actions/workflows/build_and_publish.yml[build of the extensions site] since updating the catalog"
msgstr ""
#: _guides/extension-faq.adoc
msgid "Other topics"
msgstr ""
#: _guides/extension-faq.adoc
msgid "What's the difference between a quickstart and a codestart?"
msgstr ""
#: _guides/extension-faq.adoc
msgid ""
"Both codestarts and quickstarts are designed to help users get coding quickly.\n"
"A codestarts is a generated application and a quickstart is browsable source code.\n"
"Codestarts allow the creation of customised apps, which makes them quite powerful."
msgstr ""