-
Notifications
You must be signed in to change notification settings - Fork 34
/
readme.txt
281 lines (197 loc) · 13 KB
/
readme.txt
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
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
vs-android v0.964 - 28th December 2014
======================================
vs-android is intended to provide a collection of scripts and utilities to support integrated development of
Android NDK C/C++ software under Microsoft Visual Studio.
Currently vs-android only works under Visual Studio 2010. Earlier versions lack the MSBuild integration with
the C/C++ compilation systems.
Required Support SDKs
=====================
Cygwin is not required at all to use vs-android, thankfully!
At a bare minimum the Android NDK needs to be installed. This will allow compilation of C/C++ code:
* http://developer.android.com/sdk/ndk/index.html
In order to build an apk package to run on an Android device, you'll also require:
The Android SDK:
* http://developer.android.com/sdk/index.html
The Java JDK:
* http://www.oracle.com/technetwork/java/javase/downloads/index.html
Apache Ant:
* http://ant.apache.org/
Documentation
=============
Documentation for vs-android can be found here:
* http://code.google.com/p/vs-android/
Installation:
* http://code.google.com/p/vs-android/wiki/Installation
Troubleshooting:
* http://code.google.com/p/vs-android/wiki/Troubleshooting
Version History
===============
v0.964 - 28th December 2014
* Updated to support the r10d NDK.
* GCC 4.6 has been deprecated by Google. It is still supported, but the default GCC version vs-android uses,
is now GCC 4.8.
* Added support for GCC 4.9.
* Added support for the "android-21" target (aka "Android 5.0", "Lollipop").
* Integrated "tlog" generation fix, thanks to "drew@thedunlops".
* NOTE: This version has "Ignore All Default Libraries" defaulting to "No" for GCC 4.8 and 4.9. Linker errors occur
otherwise, when using any C++ features. GCC 4.6 still defaults this to "Yes", as it doesn't exhibit issues.
v0.963 - 19th July 2014
* Fix for issue with the "Windows 64-bit" NDK. The "TRACKER : error TRK0002: Failed to execute command" error.
** Thanks to Ilya Konstantinov for the fix.
* Added warning message for using the new "(64-bit Target)" NDK.
** Confusingly there are 32-bit and 64-bit Windows flavors of the "(32-bit Target)" and "(64-bit Target)" NDKs.
** vs-android only supports the "(32-bit Target)" NDK currently.
* Also tested vs-android against the new r10 NDK. All toolchains and platforms are current.
v0.962 - 9th June 2014
* Added support for lone-installs of Visual Studio 2013.
** Thanks to ted@lindenlab, and "mellean". I simplified the approach in the end, using project imports rather
than duplicating code.
* Fixed pre/post-build steps not functioning correctly.
** Thanks to "mellean" for the fix.
* Tested against new "r9d" NDK. Appears to work fine, please let me know on the "Issues" page if I am mistaken.
v0.961 - 24th February 2014
* Added Precompiled Header support. Thanks to help from Richard Forster.
* PCH support works similarly to the Win32/x64 compilers. You can enable "Create" for the compilation unit which
should create the PCH, and "Use" for the project so have all files use that PCH.
* Projects mistakenly setting the ObjectFileName to a directory, will now have an explanatory error.
* /libs/armeabi-v7a is now used when the architecture is set to "armeabi-v7a". This addresses an issue when
submitting apk's to the Play Store. Thanks to Ilja Plutschouw.
* The default "PlatformToolset" for newly added configurations is now correctly set. Thanks to Chuck Evans.
* The BrowseInformation flag is now ignored for ClCompile. Oft-imported setting when creating an Android platform
on a Win32 project. Compilation fails if it was enabled. Thanks to C.Aragones for the headsup.
v0.96 - 4th January 2014
* Visual Studio 2013 has preliminary support now. It requires VS2012 to be installed alongside it. Unfortunately
Microsoft have radically changed how MSBuild scripts implement new platforms. VS2012 express is probably fine.
* Fix for running on the r9 NDKs. The minimum requirement is now NDK r9c.
* New NDK sees 4.3.3 and 4.7 GCC toolchains removed, and 4.8 added. vs-android now reflects these changes.
* GCC 4.8 however still seems to have issues when using the STL. It appears fine if you don't use STL.
Suggestions welcome on how to address it, my Google-fu has failed me when looking up the link errors.
Stick with GCC 4.6 if you need STL support.
* Added support for missing Android API targets: 12, 13, and 15 through 19. Goes up to Android 4.4 API now.
v0.951 - 22nd May 2013
* Fix for running on machines with a lone install of vs2010. I was doing all my testing on machines which have
a dual vs2010 and vs2012 install. Apologies.
v0.95 - 22nd May 2013
* Visual Studio 2012 is now fully supported.
* There are separate installers for vs2010 and vs2012. Scripts are identical between version, via use of
conditionals in MSBuild. However both use different supporting DLL files.
* .vcxproj and .sln files are cross-compatible between vs2012 and vs2010. Support for vs2010 will continue
for vs-android in the foreseeable future.
* The x64 version of the NDK is now supported.
* Fix for Google breaking change to paths: "4.6.x-google" -> "4.6".
* The default GCC toolchain version has been changed from 4.4.3 to 4.6.
* The build scripts are now compliant with NDK r8e. Previous NDK versions are no longer supported.
* GCC 4.7 is now an available toolchain choice. However, it is not currently usable with the STL. Google state
that 4.7 is still experimental. I'd welcome any suggested fix, if it does indeed work in ndk-build.
v0.94 - 24th July 2012
* Completely reworked the deploy and run portions of vs-android.
* Deploy has its own configuration pane: "Android Deployment", and saves these settings to the .user file.
* The Deployment process in general is much more robust. "Build->Cancel" also now works correctly when deploying.
* "Build->Deploy Solution/Deploy Project" now works on Android APK projects, to simply run the deploy step.
Enable the "Deploy" checkbox for your project in the Solution "Configuration Manager" to enable this.
* You can now run a deployed app by using "Debug->Run" (F5)! It's a bit of a hacky method, but appears to work fine.
* NDK r8b was a breaking change for vs-android. This version now requires r8b or newer to be installed.
* Fixed breaking changes to the location of libstdc++ STL libraries.
* Fix for Google breaking change to x86 paths: "i686-android-linux" -> "i686-linux-android".
* Added support for the new GCC 4.6 toolchains.
* Added support for the new MIPS toolchains.
* Tested and hopefully fixed issues such that vs-android works fully with a 64-bit JDK install.
* Fix to make it possible to build projects in paths that contain spaces. Thanks to 'null77'.
* Added 'Forced Include File' to "C/C++ -> Advanced" property sheet. Thanks to 'danfilner'.
* Fix to make sure ARM5/ARM7 GCC flags are passed correctly to the compiler. Thanks to 'Drew Dunlop'.
v0.93 - 13th November 2011
* NDK r7 was a breaking change for vs-android. This version now requires r7 or newer to be installed.
* Fixed breaking changes to the location of STL libraries. Also fixed new linking issues introduced by STL changes.
* Removed support for defunct arm 4.4.0 toolset.
* Added support for android-14, Android API v4.0.
* Added support for the dynamic (shared) version of the GNU libstdc++ STL.
* Tested against newest JDK - jdk-7u1-windows-i586.
* Added support for building assembly files. '.s' and '.asm' extensions will be treated as assembly code.
* Correct passing of ANT_OPTS to the Ant Build step. Thanks to 'mark.bozeman'.
* Corrected expected apk name for release builds.
* Added to Ant Build property page; the ability to add extra flags to the calls to adb.
* Fixed bug with arm arch preprocessor defines not making it onto the command line.
* Fixed bad quote removal on paths, in the C# code. Thanks to 'hoesing@kleinbottling'.
* Removed stlport project from Google Code - This was an oversight by Google in the r6 NDK, prebuilt is back again.
* Updated sample projects to work with R15 SDK tools.
v0.92 - 3rd August 2011
* Fixed jump-to-line clickable errors. Reworked code to use regular expressions instead. Tried a number
of different compiler/linker warnings and errors and all seems to be good
* Default warning level is now 'Normal Warnings', instead of 'Disable All Warnings'. Whoops!
* Fixed rtti-related warnings when compiling .c files with 'Enable All Warnings (-Wall)', turned on.
v0.91 - 2nd August 2011
* Windows debugger is now usable. Fixed 'CLRSupport' error.
* Error checking to ensure the 32-bit JDK is used.
* Added JVM Heap options to Ant Build step. Initial and Maximum sizes are able to be set there now.
* Added asafhel...@gmail's 'clickable errors from compiler' C# code.
* Modified clickable errors code to also work with #include errors, which specify the column number too.
* Added clickable error support to linker too.
v0.9 - 20th July 2011
* Major update, hence the skip in numbers. Closing in on a v1.0 release.
* Verified working with Android NDK r5b, r5c, and r6.
* Much of vs-android functionality moved from MSBuild script to C# tasks. Similar approach now to Microsoft's
existing Win32 setup.
* Dependency checking rewritten to use tracking log files.
* Dependency issues fixed, dependency checking also now far quicker.
* Android Property sheets now completely replace the Microsoft ones, no more rafts of unused sheets.
* Property sheets populated with many options. Switches are no longer hard-coded within vs-android script.
* STL support added. Choice between 'None', 'Minimal', 'libstdc++', and 'stlport'.
* Support for x86 compilation with r6 NDK.
* Full support for v7-a arm architecture, as well as the existing v5.
* Support for Android API directories other than just 'android-9'.
* Separated support for 'dynamic libraries' and 'applications'. Applications build to apk files.
* Response files used in build, no more command-line length limitations.
* Deploy and run within Visual Studio, adb is now invoked by vs-android.
* 'Echo command lines' feature fixed.
* All support SDK/libs (NDK, SDK, Ant, JDK) are okay living in directories with spaces in them now.
* All bugs logged within Google Code are addressed.
v0.21 - 10th Feb 2011
* Fixed issues with the 'ant build' step.
* Added a sensible error message if the NDK envvar isn't set, or is set incorrectly.
v0.2 - 1st Feb 2011
* Changed default preprocessor symbols to work the same way Microsoft's stuff does. Should fix any
issues with intellisense as well.
* Added support for scanning header dependencies
v0.1 - 30th Jan 2011
* Initial version.
* All major functionality present, barring header dependency checking.
Contributors
============
asafhel...@gmail.com - Initial 'clickable errors from compiler' C# code.
mark.bozeman - Fix for Ant Build to correctly pass ANT_OPTS.
hoesing@kleinbottling - Fix for the bad quote removal on paths, in the C# code.
null77 - Fix so that projects can be built in paths that contain spaces.
danfilner - Addition of "Forced Include File" to C/C++ property sheet.
Drew Dunlop - Fix so that ARM5/ARM7 GCC flags are passed correctly to the compiler.
Richard Forster - Assistance with Precompiled Header support.
Ilja Plutschouw - /libs/armeabi-v7a/ fix.
C.Aragones - Highlighted BrowseInformation issue.
ted@lindenlab - VS2013 lone installs.
"mellean" - VS2013 lone installs, and pre/post-build step fixes.
Ilya Konstantinov - "TRACKER : error TRK0002: Failed to execute command" 64-bit NDK fix.
drew@thedunlops - "Incorrect read.1.tlog file generated" fix.
References
==========
"Inside the Microsoft Build Engine: Using MSBuild and Team Foundation Build"
Authors: Sayed Ibrahim Hashimi, William Bartholomew
"Microsoft C/C++ Visual Studio 2010 Build Implementation"
Located here: %ProgramFiles(x86)%\MSBuild\Microsoft.Cpp
License
=======
vs-android is released under the zlib license.
http://en.wikipedia.org/wiki/Zlib_License
Copyright (c) 2014 Gavin Pugh http://www.gavpugh.com/
This software is provided 'as-is', without any express or implied
warranty. In no event will the authors be held liable for any damages
arising from the use of this software.
Permission is granted to anyone to use this software for any purpose,
including commercial applications, and to alter it and redistribute it
freely, subject to the following restrictions:
1. The origin of this software must not be misrepresented; you must not
claim that you wrote the original software. If you use this software
in a product, an acknowledgment in the product documentation would be
appreciated but is not required.
2. Altered source versions must be plainly marked as such, and must not be
misrepresented as being the original software.
3. This notice may not be removed or altered from any source
distribution.