Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Newer
Older
100644 366 lines (287 sloc) 10.639 kb
d0b1964 Manfred Moser Added complete project after setup, testing and documentation ready for ...
mosabua authored
1 Maven Android SDK Deployer
df824df Manfred Moser - changed package to com.simpligility
mosabua authored
2 --------------------------
3
2d9af36 Manfred Moser minor layout tweaks
mosabua authored
4 Author: Manfred Moser manfred@simpligility.com at [simpligility technologies inc](http://www.simpligility.com)
d0b1964 Manfred Moser Added complete project after setup, testing and documentation ready for ...
mosabua authored
5
92e48e1 Manfred Moser some more cleanup
mosabua authored
6 The Maven Android SDK Deployer is a helper maven project that can be
7 used to install the libraries necessary to build Android applications
8 with Maven and the Android Maven Plugin directly from your local
9 Android SDK installation.
10
07e55b5 Manfred Moser fixed up to support ADK 14 with moved paths and so on
mosabua authored
11 ATTENTION with ADK 14
12
2b0704a Manfred Moser cleaned up documentation and changed to default nexus url
mosabua authored
13 The SDK changed folder names again. This time for all the Google Add
14 Ons. The Maven Android SDK Deployer' is adapted to the new naming
15 scheme. To do that yourself remove all "Google APIs by Google Inc" in
07e55b5 Manfred Moser fixed up to support ADK 14 with moved paths and so on
mosabua authored
16 the android SDK manager and install them again.
17
2b0704a Manfred Moser cleaned up documentation and changed to default nexus url
mosabua authored
18 ATTENTION! Currently some android.jar artifacts are available in
19 Maven central and unless you use maps or usb related dependencies,
20 android 3.0+, the compatibility library jar files or insist on using
21 the original jar files from the local SDK install, you will not need
22 this tool anymore.
6421964 Manfred Moser updated documentation to detail that android jar files are now in maven ...
mosabua authored
23
2b0704a Manfred Moser cleaned up documentation and changed to default nexus url
mosabua authored
24 You will however need this tool to access the latest Android 2.3
25 release or to work around bugs like missing JSON libraries in some
26 older artifacts deployed to Maven central. If you use this tool make
27 sure your dependencies are as documented here.
18ec322 Manfred Moser added support for the latest Android release 2.3 (Gingerbread)
mosabua authored
28
2b0704a Manfred Moser cleaned up documentation and changed to default nexus url
mosabua authored
29 The android.jar artifacts in Maven central are available with the
30 groupId com.google.android, whereas this tool uses android.android to
31 avoid overlap.
d0b1964 Manfred Moser Added complete project after setup, testing and documentation ready for ...
mosabua authored
32
33 How to Use
34 ----------
35
92e48e1 Manfred Moser some more cleanup
mosabua authored
36 Download the latest Android SDK from
37 http://developer.android.com/sdk/index.html following the instructions
38 there.
f24475c Manfred Moser updated documentation in reaction to issue 5
mosabua authored
39
92e48e1 Manfred Moser some more cleanup
mosabua authored
40 - For the default usage of the deployer install **all platforms and
41 add-on apis**, ensure that all folder in the platforms folder have
42 names like android-3, android-4 and so on.
43
44 - If you find names using the platform version (e.g. 15) in the folder
45 name reinstall that platform from the android tool.
df824df Manfred Moser - changed package to com.simpligility
mosabua authored
46
92e48e1 Manfred Moser some more cleanup
mosabua authored
47 - In a similar manner the folder names in add-ons have to use the
48 pattern addon_google_apis_google_inc_-3 up to
49 addon_google_apis_google_inc_-8. - If the folder names are different
50 reinstall the add-ons as well
51
52 Set up the environment variable ANDROID_HOME to contain the absolute
53 folder you just installed the SDK to (e.g. under bash: export
54 ANDROID_HOME=/opt/android_sdk_linux) and ensure that the folder for
55 ANDROID_HOME and all files within are readable by the current user
56
57 Run the command
556b2e3 Manfred Moser markdown layout improvements only
mosabua authored
58
59 mvn install
60
92e48e1 Manfred Moser some more cleanup
mosabua authored
61 in the root folder of this project (same as README you are just
62 reading) to install all platforms and add-on apis
d0b1964 Manfred Moser Added complete project after setup, testing and documentation ready for ...
mosabua authored
63
92e48e1 Manfred Moser some more cleanup
mosabua authored
64 To install only a certain sdk level use
d0b1964 Manfred Moser Added complete project after setup, testing and documentation ready for ...
mosabua authored
65
556b2e3 Manfred Moser markdown layout improvements only
mosabua authored
66 mvn install -P 1.5
67 mvn install -P 1.6
68 mvn install -P 2.1
dc6058b Manfred Moser upgraded to add support for platform 2.2. (froyo)
mosabua authored
69 mvn install -P 2.2
6c73750 Manfred Moser documented new profile for 2.3.3
mosabua authored
70 mvn install -P 2.3.3
17b42b3 Manfred Moser removed honeycomb preview release and updated documentation
mosabua authored
71 mvn install -P 3.0
482a565 Jake Wharton Add support for Android 3.2 and the compatiblitiy library v13.
JakeWharton authored
72 mvn install -P 3.1
73 mvn install -P 3.2
92e48e1 Manfred Moser some more cleanup
mosabua authored
74 mvn install -P 4.0
482a565 Jake Wharton Add support for Android 3.2 and the compatiblitiy library v13.
JakeWharton authored
75
92e48e1 Manfred Moser some more cleanup
mosabua authored
76 As a result you should find the android.jar and maps.jar in various
77 versions in your users local repository (~/.m2/repository/android and
78 ~/.m2/repository/com/google/android/maps and ) and you can therefore
79 use the following dependencies in your project
d0b1964 Manfred Moser Added complete project after setup, testing and documentation ready for ...
mosabua authored
80
92e48e1 Manfred Moser some more cleanup
mosabua authored
81 For the core platforms
d0b1964 Manfred Moser Added complete project after setup, testing and documentation ready for ...
mosabua authored
82
c1bad72 Manfred Moser changed GAV coordinates for compatibility extras to better reflect usage
mosabua authored
83 <dependency>
84 <groupId>android</groupId>
85 <artifactId>android</artifactId>
86 <version>1.5_r4</version>
87 <scope>provided</scope>
88 </dependency>
89
90 <dependency>
91 <groupId>android</groupId>
92 <artifactId>android</artifactId>
93 <version>1.6_r3</version>
94 <scope>provided</scope>
95 </dependency>
96
97 <dependency>
98 <groupId>android</groupId>
99 <artifactId>android</artifactId>
07e55b5 Manfred Moser fixed up to support ADK 14 with moved paths and so on
mosabua authored
100 <version>2.1_r3</version>
c1bad72 Manfred Moser changed GAV coordinates for compatibility extras to better reflect usage
mosabua authored
101 <scope>provided</scope>
102 </dependency>
103
104 <dependency>
105 <groupId>android</groupId>
106 <artifactId>android</artifactId>
07e55b5 Manfred Moser fixed up to support ADK 14 with moved paths and so on
mosabua authored
107 <version>2.2_r3</version>
c1bad72 Manfred Moser changed GAV coordinates for compatibility extras to better reflect usage
mosabua authored
108 <scope>provided</scope>
109 </dependency>
110
111 <dependency>
112 <groupId>android</groupId>
113 <artifactId>android</artifactId>
07e55b5 Manfred Moser fixed up to support ADK 14 with moved paths and so on
mosabua authored
114 <version>2.3.3_r2</version>
c1bad72 Manfred Moser changed GAV coordinates for compatibility extras to better reflect usage
mosabua authored
115 <scope>provided</scope>
116 </dependency>
117
118 <dependency>
119 <groupId>android</groupId>
120 <artifactId>android</artifactId>
07e55b5 Manfred Moser fixed up to support ADK 14 with moved paths and so on
mosabua authored
121 <version>3.0_r2</version>
c1bad72 Manfred Moser changed GAV coordinates for compatibility extras to better reflect usage
mosabua authored
122 <scope>provided</scope>
123 </dependency>
124
125 <dependency>
126 <groupId>android</groupId>
127 <artifactId>android</artifactId>
07e55b5 Manfred Moser fixed up to support ADK 14 with moved paths and so on
mosabua authored
128 <version>3.1_r3</version>
c1bad72 Manfred Moser changed GAV coordinates for compatibility extras to better reflect usage
mosabua authored
129 <scope>provided</scope>
130 </dependency>
131
132 <dependency>
133 <groupId>android</groupId>
134 <artifactId>android</artifactId>
135 <version>3.2_r1</version>
136 <scope>provided</scope>
137 </dependency>
138
07e55b5 Manfred Moser fixed up to support ADK 14 with moved paths and so on
mosabua authored
139 <dependency>
140 <groupId>android</groupId>
141 <artifactId>android</artifactId>
e341354 Manfred Moser updated versions to new releases of ics and compat lib
mosabua authored
142 <version>4.0_r3</version>
07e55b5 Manfred Moser fixed up to support ADK 14 with moved paths and so on
mosabua authored
143 <scope>provided</scope>
144 </dependency>
145
92e48e1 Manfred Moser some more cleanup
mosabua authored
146 For the maps add ons
c1bad72 Manfred Moser changed GAV coordinates for compatibility extras to better reflect usage
mosabua authored
147
148 <dependency>
149 <groupId>com.google.android.maps</groupId>
150 <artifactId>maps</artifactId>
151 <version>3_r3</version>
152 <scope>provided</scope>
153 </dependency>
154
155 <dependency>
156 <groupId>com.google.android.maps</groupId>
157 <artifactId>maps</artifactId>
158 <version>4_r2</version>
159 <scope>provided</scope>
160 </dependency>
161
162 <dependency>
163 <groupId>com.google.android.maps</groupId>
164 <artifactId>maps</artifactId>
165 <version>7_r1</version>
166 <scope>provided</scope>
167 </dependency>
168
169 <dependency>
170 <groupId>com.google.android.maps</groupId>
171 <artifactId>maps</artifactId>
172 <version>8_r2</version>
173 <scope>provided</scope>
174 </dependency>
175
176 <dependency>
177 <groupId>com.google.android.maps</groupId>
178 <artifactId>maps</artifactId>
07e55b5 Manfred Moser fixed up to support ADK 14 with moved paths and so on
mosabua authored
179 <version>10_r2</version>
c1bad72 Manfred Moser changed GAV coordinates for compatibility extras to better reflect usage
mosabua authored
180 <scope>provided</scope>
181 </dependency>
182
183 <dependency>
184 <groupId>com.google.android.maps</groupId>
185 <artifactId>maps</artifactId>
186 <version>11_r1</version>
187 <scope>provided</scope>
188 </dependency>
189
190 <dependency>
191 <groupId>com.google.android.maps</groupId>
192 <artifactId>maps</artifactId>
193 <version>12_r1</version>
194 <scope>provided</scope>
195 </dependency>
196
197 <dependency>
198 <groupId>com.google.android.maps</groupId>
199 <artifactId>maps</artifactId>
200 <version>13_r1</version>
201 <scope>provided</scope>
202 </dependency>
203
07e55b5 Manfred Moser fixed up to support ADK 14 with moved paths and so on
mosabua authored
204 <dependency>
205 <groupId>com.google.android.maps</groupId>
206 <artifactId>maps</artifactId>
e97436e Manfred Moser updated revisions for deployed artifacts after sdk r16 release
mosabua authored
207 <version>14_r2</version>
07e55b5 Manfred Moser fixed up to support ADK 14 with moved paths and so on
mosabua authored
208 <scope>provided</scope>
209 </dependency>
210
92e48e1 Manfred Moser some more cleanup
mosabua authored
211 For the usb add on
70c49b5 Manfred Moser fixed up support for usb library for platforms 10, 12, and 13
mosabua authored
212
31e6e0d Manfred Moser fixed readme layout
mosabua authored
213 <dependency>
70c49b5 Manfred Moser fixed up support for usb library for platforms 10, 12, and 13
mosabua authored
214 <groupId>com.android.future</groupId>
215 <artifactId>usb</artifactId>
e97436e Manfred Moser updated revisions for deployed artifacts after sdk r16 release
mosabua authored
216 <version>10_r2</version>
70c49b5 Manfred Moser fixed up support for usb library for platforms 10, 12, and 13
mosabua authored
217 <scope>provided</scope>
218 </dependency>
219
220 <dependency>
221 <groupId>com.android.future</groupId>
222 <artifactId>usb</artifactId>
223 <version>12_r1</version>
224 <scope>provided</scope>
225 </dependency>
226
227 <dependency>
228 <groupId>com.android.future</groupId>
229 <artifactId>usb</artifactId>
230 <version>13_r1</version>
231 <scope>provided</scope>
232 </dependency>
233
07e55b5 Manfred Moser fixed up to support ADK 14 with moved paths and so on
mosabua authored
234 <dependency>
235 <groupId>com.android.future</groupId>
236 <artifactId>usb</artifactId>
e97436e Manfred Moser updated revisions for deployed artifacts after sdk r16 release
mosabua authored
237 <version>14_r2</version>
07e55b5 Manfred Moser fixed up to support ADK 14 with moved paths and so on
mosabua authored
238 <scope>provided</scope>
239 </dependency>
240
92e48e1 Manfred Moser some more cleanup
mosabua authored
241 For the compatibility extra (ATTENTION! Do NOT use provided scope!!)
c1bad72 Manfred Moser changed GAV coordinates for compatibility extras to better reflect usage
mosabua authored
242
243 <dependency>
244 <groupId>android.support</groupId>
245 <artifactId>compatibility-v4</artifactId>
e341354 Manfred Moser updated versions to new releases of ics and compat lib
mosabua authored
246 <version>r6</version>
c1bad72 Manfred Moser changed GAV coordinates for compatibility extras to better reflect usage
mosabua authored
247 </dependency>
248
249 <dependency>
250 <groupId>android.support</groupId>
251 <artifactId>compatibility-v13</artifactId>
e341354 Manfred Moser updated versions to new releases of ics and compat lib
mosabua authored
252 <version>r6</version>
c1bad72 Manfred Moser changed GAV coordinates for compatibility extras to better reflect usage
mosabua authored
253 </dependency>
482a565 Jake Wharton Add support for Android 3.2 and the compatiblitiy library v13.
JakeWharton authored
254
bb5a3f7 Manfred Moser support for the honeycomb backport static library
mosabua authored
255
92e48e1 Manfred Moser some more cleanup
mosabua authored
256 To install only a specific module use
96d71a9 Manfred Moser support for 3.1 aka api 12 added
mosabua authored
257
258 mvn clean install -N
259
92e48e1 Manfred Moser some more cleanup
mosabua authored
260 in any parent folder of the desired package and then the usual
e97436e Manfred Moser updated revisions for deployed artifacts after sdk r16 release
mosabua authored
261 1
96d71a9 Manfred Moser support for 3.1 aka api 12 added
mosabua authored
262 mvn clean install
263
92e48e1 Manfred Moser some more cleanup
mosabua authored
264 For example to install only the compatibility v4 extra you can do the
265 following
00fd0cf Manfred Moser removed erratic character added
mosabua authored
266
96d71a9 Manfred Moser support for 3.1 aka api 12 added
mosabua authored
267 mvn clean install -N
268 cd extras
269 mvn clean install -N
270 cd compatibility-v4
271 mvn clean install
272
92e48e1 Manfred Moser some more cleanup
mosabua authored
273 Similar for only API level 12 add on use
96d71a9 Manfred Moser support for 3.1 aka api 12 added
mosabua authored
274
275 mvn clean install -N
276 cd add-ons
277 mvn clean install -N
278 cd google-apis-12
279 mvn clean install
280
92e48e1 Manfred Moser some more cleanup
mosabua authored
281 The same could be done with deploy
96d71a9 Manfred Moser support for 3.1 aka api 12 added
mosabua authored
282
283
2268fbd Manfred Moser add functionality to deploy to remote server, added sdk 2.0.1 release ar...
mosabua authored
284 How To Use for Deploying Onto Remote Server
285 -------------------------------------------
286
2b0704a Manfred Moser cleaned up documentation and changed to default nexus url
mosabua authored
287 The above deployment works fine for one machine, but what if you need
288 to supply a whole team of developers and a cluster of build machines
b6e0413 Manfred Moser trying again with some more reformatting
mosabua authored
289 with the artifacts.
2268fbd Manfred Moser add functionality to deploy to remote server, added sdk 2.0.1 release ar...
mosabua authored
290
b6e0413 Manfred Moser trying again with some more reformatting
mosabua authored
291 As a condition you need to have a repository server used by all
2b0704a Manfred Moser cleaned up documentation and changed to default nexus url
mosabua authored
292 those machines and the following process will deploy to this server,
293 which will in turn provide the artifacts to all the machines.
2268fbd Manfred Moser add functionality to deploy to remote server, added sdk 2.0.1 release ar...
mosabua authored
294
b6e0413 Manfred Moser trying again with some more reformatting
mosabua authored
295 Edit the repo.url property in the pom.xml to point to the repository
2b0704a Manfred Moser cleaned up documentation and changed to default nexus url
mosabua authored
296 you want to publish to and then add a server with the credentials to
297 your settings.xml.
2268fbd Manfred Moser add functionality to deploy to remote server, added sdk 2.0.1 release ar...
mosabua authored
298
2b0704a Manfred Moser cleaned up documentation and changed to default nexus url
mosabua authored
299 <settings>
300 <servers>
2268fbd Manfred Moser add functionality to deploy to remote server, added sdk 2.0.1 release ar...
mosabua authored
301 <server>
2b0704a Manfred Moser cleaned up documentation and changed to default nexus url
mosabua authored
302 <id>android.repo</id>
303 <username>your username</username>
304 <password>your password</password>
2268fbd Manfred Moser add functionality to deploy to remote server, added sdk 2.0.1 release ar...
mosabua authored
305 </server>
2b0704a Manfred Moser cleaned up documentation and changed to default nexus url
mosabua authored
306 </servers>
307 </settings>
2268fbd Manfred Moser add functionality to deploy to remote server, added sdk 2.0.1 release ar...
mosabua authored
308
b6e0413 Manfred Moser trying again with some more reformatting
mosabua authored
309 Run the command
556b2e3 Manfred Moser markdown layout improvements only
mosabua authored
310
311 mvn deploy
312
b6e0413 Manfred Moser trying again with some more reformatting
mosabua authored
313 in the root folder of this project (same as README you are just
314 reading), you can also use the same profile options for the different
315 api level. As a result you should find the artifact in the repository
316 of your remote server
2268fbd Manfred Moser add functionality to deploy to remote server, added sdk 2.0.1 release ar...
mosabua authored
317
2b0704a Manfred Moser cleaned up documentation and changed to default nexus url
mosabua authored
318 For more information about this stuff look at the documentation for
319 the maven-deploy-plugin.
2268fbd Manfred Moser add functionality to deploy to remote server, added sdk 2.0.1 release ar...
mosabua authored
320
0931ff1 Manfred Moser documentation updates with solution to reoccuring issue with platform fo...
mosabua authored
321 Mailinglist - Questions
322 -----------------------
323
2b0704a Manfred Moser cleaned up documentation and changed to default nexus url
mosabua authored
324 Please direct any questions to the community at the Maven Android
325 Developers mailing list at
18ec322 Manfred Moser added support for the latest Android release 2.3 (Gingerbread)
mosabua authored
326 http://groups.google.com/group/maven-android-developers
0931ff1 Manfred Moser documentation updates with solution to reoccuring issue with platform fo...
mosabua authored
327
df824df Manfred Moser - changed package to com.simpligility
mosabua authored
328 Known problems
452e9f3 Manfred Moser version 0.4 commit
mosabua authored
329 -------------
330
0931ff1 Manfred Moser documentation updates with solution to reoccuring issue with platform fo...
mosabua authored
331 - Platforms and Add on folder names changes in SDK
332
2b0704a Manfred Moser cleaned up documentation and changed to default nexus url
mosabua authored
333 When updating an existing android sdk install the add-ons subfolder
334 can sometimes be reused and their contents be updates so you could end
335 up with e.g. the google maps-4r2 in a folder named
336 google_apis-4_r01. To work around this just uninstall the affected
337 add-on and reinstall it with the android sdk tool.
452e9f3 Manfred Moser version 0.4 commit
mosabua authored
338
2b0704a Manfred Moser cleaned up documentation and changed to default nexus url
mosabua authored
339 Similarly the platform specific folder used to be e.g. android-1.5 and
340 is now android-3 using the api level as the numeric identifier. If
341 your SDK install uses the old folder names for any platform simply
342 reinstall that platform with the android tool.
0931ff1 Manfred Moser documentation updates with solution to reoccuring issue with platform fo...
mosabua authored
343
344 Issues
345 ------
346
2b0704a Manfred Moser cleaned up documentation and changed to default nexus url
mosabua authored
347 If you find any problems or would like to suggest a feature, please
348 feel free to file an issue on github at
18ec322 Manfred Moser added support for the latest Android release 2.3 (Gingerbread)
mosabua authored
349 http://github.com/mosabua/maven-android-sdk-deployer/issues
0931ff1 Manfred Moser documentation updates with solution to reoccuring issue with platform fo...
mosabua authored
350
d0b1964 Manfred Moser Added complete project after setup, testing and documentation ready for ...
mosabua authored
351 Potential todo items
352 --------------------
353
2b0704a Manfred Moser cleaned up documentation and changed to default nexus url
mosabua authored
354 - add custom pom files for install/deploy that eg. define dependency
355 from maps to android jar
2268fbd Manfred Moser add functionality to deploy to remote server, added sdk 2.0.1 release ar...
mosabua authored
356
357 - maybe some sort of reporting of errors, failures and success as well
d0b1964 Manfred Moser Added complete project after setup, testing and documentation ready for ...
mosabua authored
358
2d9af36 Manfred Moser minor layout tweaks
mosabua authored
359 Additional Contributors
360 -----------------------
df824df Manfred Moser - changed package to com.simpligility
mosabua authored
361
47f445f Manfred Moser fixed readme list of contribs
mosabua authored
362 - Hugo Josefson <hugo@josefson.org> - properties plugin usage
363 - Jake Wharton <jakewharton@gmail.com> - 3.2 and compatibility v13 support
364 - https://github.com/holdensmagicalunicorn - spelling fix
07e55b5 Manfred Moser fixed up to support ADK 14 with moved paths and so on
mosabua authored
365 - Guto Maia <guto@guto.net>- initial USB add on support
366 - Lorenzo Villani - initial 4.0 support
Something went wrong with that request. Please try again.