Author: vjrj_ Date: 2012-03-06 15:15:12 +0100 (Tue, 06 Mar 2012) New Revision: 1741 Modified: trunk/DEV-GUIDE trunk/INSTALL Log: More doc Modified: trunk/DEV-GUIDE =================================================================== --- trunk/DEV-GUIDE 2012-03-06 13:25:45 UTC (rev 1740) +++ trunk/DEV-GUIDE 2012-03-06 14:15:12 UTC (rev 1741) @@ -53,8 +53,15 @@ Of course, you can use other IDEs (and please help us to improve this doc in this case). -===Optional maven-eclipse integration === +====Some mandatory plugins for Eclipse==== +From the Eclipse Marketplace (Help > Eclipse Marketplace) install: + +* Google Plugin for Eclipse https://code.google.com/intl/en/eclipse/docs/getting_started.html +* Subversive or Subclipse + +====Optional maven-eclipse integration ==== + Check: http://google-web-toolkit.googlecode.com/svn/trunk/samples/expenses/README-M... @@ -72,7 +79,7 @@ (*) Note: We actually use script/mvn-eclipse.sh instead of a simple 'mvn eclipse:eclipse' to hack a little bit the .classpath, because "mvn eclipse:eclipse" removes the GWT_CONTAINER line a the end of the .classpath. You can fix it from eclipse (anytime that we change the dependencies and you have to do a 'mvn eclipse:eclipse'), but we prefer to do it that way from the command line. -====Configure Google GWT Plugin=== +====Configure Google GWT Plugin==== For now we are using GWT 2.1.1 (not necessary match the one from the eclipse GWT plugin) so probably you have to download the SDK from: http://code.google.com/p/google-web-toolkit/downloads/list @@ -84,18 +91,19 @@ Also in Kune project properties > Google > Web Toolkit > Check that you are using the 2.1.1 SDK. -===UTF 8=== +====Configure the Firefox GWT Plugin==== -The charset used in Kune is UTF8. In Eclipse, check the text-file enconding in Package Explorer > Preferences > Resource > Text file encoding. +For that check this from Firefox: +http://gwt.google.com/missing-plugin/MissingPlugin.html +some times GWT plugin is not available for newers FF, so you have to search in the GWT dev forums for a nightly extension. -Please don't send patchs in other charsets. +====UTF 8==== -====Some mandatory plugins for Eclipse==== +The charset used in Kune is UTF8. In Eclipse, check the text-file enconding in Package Explorer > Preferences > Resource > Text file encoding. -From the Eclipse Marketplace (Help > Eclipse Marketplace) install: +You can change this globally in General > Workspace. -* Google Plugin for Eclipse https://code.google.com/intl/en/eclipse/docs/getting_started.html -* Subversive or Subclipse +Note: Please don't send patchs in other charsets. ====Some other recomended & suggested plugins for Eclipse==== @@ -120,12 +128,12 @@ ===Install Kune=== -Only after making sure the previous steps have been finished, you can proceed to the installation of Kune. For doing so, you need to follow the instructions of the document INSTALL, available in kune/trunk/INSTALL. Afterwards you will be able to run Kune for the first time. This will initialize the database, and configure the XMPP server, among other things. +Only after making sure the previous steps have been finished, you can proceed to the installation of the rest of Kune. For doing so, you need to follow the instructions of the document INSTALL, available in kune/trunk/INSTALL. Afterwards you will be able to run Kune for the first time. ===GWT's Hosted Mode=== Before run hosted mode for the first time compile once with: - mvn compile && mvn gwt:compile + mvn compile -Dliquibase.should.run=false && mvn gwt:compile and deploy with: script/deploy_gwt.sh Modified: trunk/INSTALL =================================================================== --- trunk/INSTALL 2012-03-06 13:25:45 UTC (rev 1740) +++ trunk/INSTALL 2012-03-06 14:15:12 UTC (rev 1741) @@ -146,13 +146,14 @@ mysql -p -u kune < script/kune_initialize.sql -(Windows users can use Mysql Browser to execute this SQL). +(Windows users can use Mysql Browser to execute this SQL: File > Open Script > Select "script\kune_initialize.sql" > Execute). And if all goes ok, migrate the database: script/liquibase-migrate.sh -Windows users should do this by hand or adapt this (simple) script to Windows. +Windows developer users should do this by hand or adapt this (simple) script to Windows or simple: +mvn compile -Dliquibase.should.run=true (or mvn compile) ===Run the server===