Skip to content

Commit b373975

Browse files
shai-almogshai-almog
authored
Added demo code for the developer guide (#4059)
1 parent e9ae618 commit b373975

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

48 files changed

+3845
-0
lines changed

‎docs/demos/.mvn/jvm.config‎

Whitespace-only changes.

‎docs/demos/.mvn/wrapper/MavenWrapperDownloader.java‎

Lines changed: 117 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,117 @@
1+
/*
2+
* Copyright 2007-present the original author or authors.
3+
*
4+
* Licensed under the Apache License, Version 2.0 (the "License");
5+
* you may not use this file except in compliance with the License.
6+
* You may obtain a copy of the License at
7+
*
8+
* http://www.apache.org/licenses/LICENSE-2.0
9+
*
10+
* Unless required by applicable law or agreed to in writing, software
11+
* distributed under the License is distributed on an "AS IS" BASIS,
12+
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13+
* See the License for the specific language governing permissions and
14+
* limitations under the License.
15+
*/
16+
import java.net.*;
17+
import java.io.*;
18+
import java.nio.channels.*;
19+
import java.util.Properties;
20+
21+
public class MavenWrapperDownloader {
22+
23+
private static final String WRAPPER_VERSION = "0.5.6";
24+
/**
25+
* Default URL to download the maven-wrapper.jar from, if no 'downloadUrl' is provided.
26+
*/
27+
private static final String DEFAULT_DOWNLOAD_URL = "https://repo.maven.apache.org/maven2/io/takari/maven-wrapper/"
28+
+ WRAPPER_VERSION + "/maven-wrapper-" + WRAPPER_VERSION + ".jar";
29+
30+
/**
31+
* Path to the maven-wrapper.properties file, which might contain a downloadUrl property to
32+
* use instead of the default one.
33+
*/
34+
private static final String MAVEN_WRAPPER_PROPERTIES_PATH =
35+
".mvn/wrapper/maven-wrapper.properties";
36+
37+
/**
38+
* Path where the maven-wrapper.jar will be saved to.
39+
*/
40+
private static final String MAVEN_WRAPPER_JAR_PATH =
41+
".mvn/wrapper/maven-wrapper.jar";
42+
43+
/**
44+
* Name of the property which should be used to override the default download url for the wrapper.
45+
*/
46+
private static final String PROPERTY_NAME_WRAPPER_URL = "wrapperUrl";
47+
48+
public static void main(String args[]) {
49+
System.out.println("- Downloader started");
50+
File baseDirectory = new File(args[0]);
51+
System.out.println("- Using base directory: " + baseDirectory.getAbsolutePath());
52+
53+
// If the maven-wrapper.properties exists, read it and check if it contains a custom
54+
// wrapperUrl parameter.
55+
File mavenWrapperPropertyFile = new File(baseDirectory, MAVEN_WRAPPER_PROPERTIES_PATH);
56+
String url = DEFAULT_DOWNLOAD_URL;
57+
if(mavenWrapperPropertyFile.exists()) {
58+
FileInputStream mavenWrapperPropertyFileInputStream = null;
59+
try {
60+
mavenWrapperPropertyFileInputStream = new FileInputStream(mavenWrapperPropertyFile);
61+
Properties mavenWrapperProperties = new Properties();
62+
mavenWrapperProperties.load(mavenWrapperPropertyFileInputStream);
63+
url = mavenWrapperProperties.getProperty(PROPERTY_NAME_WRAPPER_URL, url);
64+
} catch (IOException e) {
65+
System.out.println("- ERROR loading '" + MAVEN_WRAPPER_PROPERTIES_PATH + "'");
66+
} finally {
67+
try {
68+
if(mavenWrapperPropertyFileInputStream != null) {
69+
mavenWrapperPropertyFileInputStream.close();
70+
}
71+
} catch (IOException e) {
72+
// Ignore ...
73+
}
74+
}
75+
}
76+
System.out.println("- Downloading from: " + url);
77+
78+
File outputFile = new File(baseDirectory.getAbsolutePath(), MAVEN_WRAPPER_JAR_PATH);
79+
if(!outputFile.getParentFile().exists()) {
80+
if(!outputFile.getParentFile().mkdirs()) {
81+
System.out.println(
82+
"- ERROR creating output directory '" + outputFile.getParentFile().getAbsolutePath() + "'");
83+
}
84+
}
85+
System.out.println("- Downloading to: " + outputFile.getAbsolutePath());
86+
try {
87+
downloadFileFromURL(url, outputFile);
88+
System.out.println("Done");
89+
System.exit(0);
90+
} catch (Throwable e) {
91+
System.out.println("- Error downloading");
92+
e.printStackTrace();
93+
System.exit(1);
94+
}
95+
}
96+
97+
private static void downloadFileFromURL(String urlString, File destination) throws Exception {
98+
if (System.getenv("MVNW_USERNAME") != null && System.getenv("MVNW_PASSWORD") != null) {
99+
String username = System.getenv("MVNW_USERNAME");
100+
char[] password = System.getenv("MVNW_PASSWORD").toCharArray();
101+
Authenticator.setDefault(new Authenticator() {
102+
@Override
103+
protected PasswordAuthentication getPasswordAuthentication() {
104+
return new PasswordAuthentication(username, password);
105+
}
106+
});
107+
}
108+
URL website = new URL(urlString);
109+
ReadableByteChannel rbc;
110+
rbc = Channels.newChannel(website.openStream());
111+
FileOutputStream fos = new FileOutputStream(destination);
112+
fos.getChannel().transferFrom(rbc, 0, Long.MAX_VALUE);
113+
fos.close();
114+
rbc.close();
115+
}
116+
117+
}

‎docs/demos/.mvn/wrapper/maven-wrapper.properties‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.6.3/apache-maven-3.6.3-bin.zip
2+
wrapperUrl=https://repo.maven.apache.org/maven2/io/takari/maven-wrapper/0.5.6/maven-wrapper-0.5.6.jar

‎docs/demos/.vscode/extensions.json‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
{"recommendations": ["vscjava.vscode-java-pack"]}

‎docs/demos/.vscode/settings.json‎

Lines changed: 58 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,58 @@
1+
{"maven.terminal.favorites": [
2+
{
3+
"alias": "Cloud > iOS Release Build",
4+
"command": "\"package\" \"-DskipTests\" \"-Dcodename1.platform=ios\" \"-Dcodename1.buildTarget=ios-device-release\" \"-U\" \"-e\""
5+
},
6+
{
7+
"alias": "Tools > Codename One Settings",
8+
"command": "\"cn1:settings\" \"-U\" \"-e\""
9+
},
10+
{
11+
"alias": "Run in Simulator",
12+
"command": "\"verify\" \"-Psimulator\" \"-DskipTests\" \"-Dcodename1.platform=javase\" \"-e\""
13+
},
14+
{
15+
"alias": "Cloud > Mac Desktop Build",
16+
"command": "\"package\" \"-DskipTests\" \"-Dcodename1.platform=javase\" \"-Dcodename1.buildTarget=mac-os-x-desktop\" \"-U\" \"-e\""
17+
},
18+
{
19+
"alias": "Cloud > Android Build",
20+
"command": "\"package\" \"-DskipTests\" \"-Dcodename1.platform=android\" \"-Dcodename1.buildTarget=android-device\" \"-U\" \"-e\""
21+
},
22+
{
23+
"alias": "Tools > Update Codename One",
24+
"command": "\"cn1:update\" \"-U\" \"-e\""
25+
},
26+
{
27+
"alias": "Cloud > iOS Debug Build",
28+
"command": "\"package\" \"-DskipTests\" \"-Dcodename1.platform=ios\" \"-Dcodename1.buildTarget=ios-device\" \"-U\" \"-e\""
29+
},
30+
{
31+
"alias": "Local > Xcode iOS Project",
32+
"command": "\"package\" \"-DskipTests\" \"-Dcodename1.platform=ios\" \"-Dcodename1.buildTarget=ios-source\" \"-U\" \"-e\""
33+
},
34+
{
35+
"alias": "Cloud > Javascript Build",
36+
"command": "\"package\" \"-DskipTests\" \"-Dcodename1.platform=javascript\" \"-Dcodename1.buildTarget=javascript\" \"-U\" \"-e\""
37+
},
38+
{
39+
"alias": "Cloud > Windows Desktop Build",
40+
"command": "\"package\" \"-DskipTests\" \"-Dcodename1.platform=javase\" \"-Dcodename1.buildTarget=windows-desktop\" \"-U\" \"-e\""
41+
},
42+
{
43+
"alias": "Run as Desktop App",
44+
"command": "\"verify\" \"-Prun-desktop\" \"-DskipTests\" \"-Dcodename1.platform=javase\" \"-e\""
45+
},
46+
{
47+
"alias": "Cloud > Windows Device Build (UWP)",
48+
"command": "\"package\" \"-DskipTests\" \"-Dcodename1.platform=win\" \"-Dcodename1.buildTarget=windows-device\" \"-U\" \"-e\""
49+
},
50+
{
51+
"alias": "Local > Gradle Android Project",
52+
"command": "\"package\" \"-DskipTests\" \"-Dcodename1.platform=android\" \"-Dcodename1.buildTarget=android-source\" \"-U\" \"-e\""
53+
},
54+
{
55+
"alias": "Local > Cross-platform (JavaSE) Desktop App",
56+
"command": "\"-Pexecutable-jar\" \"package\" \"-Dcodename1.platform=javase\" \"-DskipTests\" \"-U\" \"-e\""
57+
}
58+
]}

‎docs/demos/README.adoc‎

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
= Codename One Project
2+
3+
This is a multi-module maven project for building a Codename One application. Codename One applications written in Java and/or Kotlin, and are built as native apps and can be built and deployed to iOS, Android, Mac, Windows, Linux, and also to the Web.
4+
5+
== Getting Started
6+
7+
=== Java
8+
9+
If you plan to use Java as your primary language, https://shannah.github.io/cn1-maven-archetypes/cn1app-archetype-tutorial/getting-started.html[start here].
10+
11+
=== Kotlin
12+
13+
If you plan to use Kotlin as your primary language, https://shannah.github.io/cn1app-archetype-kotlin-template/getting-started.html[start here].
14+
15+
16+
== Eclipse Users
17+
18+
IMPORTANT: If you use Eclipse as your IDE, **read this first**
19+
20+
The _tools/eclipse_ directory contains eclipse ".launch" files that will add common Maven goals as menu items inside Eclipse.
21+
22+
**After importing this project into Eclipse, you should import the launch files.**
23+
24+
=== Additional Steps for CodeRAD projects
25+
26+
CodeRAD includes an annotation processor that needs to be activated. There are a few additional steps required to enable this in Eclipse.
27+
28+
. Add `org.eclipse.m2e.apt.mode=jdt_apt` to the `./common/.settings/org.eclipse.m2e.apt.prefs`
29+
. Add `target/generated-sources/rad-views` to the .classpath.
30+
31+
See https://github.com/codenameone/CodenameOne/issues/3724[this issue] for more details.
32+
33+
== NetBeans Users
34+
35+
This project is a multi-module Maven project that was generated from a Maven archetype.
36+
37+
== IntelliJ Users
38+
39+
The project should work in IntelliJ out of the box. No need to copy any files.
40+
41+
== Help and Support
42+
43+
See the https://www.codenameone.com[Codename One Web Site].

‎docs/demos/android/pom.xml‎

Lines changed: 134 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,134 @@
1+
<?xml version="1.0" encoding="UTF-8"?>
2+
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
3+
<modelVersion>4.0.0</modelVersion>
4+
<parent>
5+
<groupId>com.codenameone.developerguide</groupId>
6+
<artifactId>democode</artifactId>
7+
<version>1.0-SNAPSHOT</version>
8+
</parent>
9+
<groupId>com.codenameone.developerguide</groupId>
10+
<artifactId>democode-android</artifactId>
11+
<version>1.0-SNAPSHOT</version>
12+
13+
<name>democode-android</name>
14+
15+
<properties>
16+
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
17+
<maven.compiler.source>1.8</maven.compiler.source>
18+
<maven.compiler.target>1.8</maven.compiler.target>
19+
<codename1.platform>android</codename1.platform>
20+
<codename1.projectPlatform>android</codename1.projectPlatform>
21+
<codename1.defaultBuildTarget>android-device</codename1.defaultBuildTarget>
22+
</properties>
23+
<build>
24+
<sourceDirectory>src/main/empty</sourceDirectory>
25+
<resources>
26+
27+
<resource>
28+
<directory>src/main/java</directory>
29+
</resource>
30+
<resource>
31+
<directory>src/main/resources</directory>
32+
</resource>
33+
</resources>
34+
<plugins>
35+
<plugin>
36+
<groupId>com.codenameone</groupId>
37+
<artifactId>codenameone-maven-plugin</artifactId>
38+
<version>${cn1.plugin.version}</version>
39+
<executions>
40+
<execution>
41+
<id>build-android</id>
42+
<phase>package</phase>
43+
<goals>
44+
<goal>build</goal>
45+
</goals>
46+
</execution>
47+
</executions>
48+
</plugin>
49+
50+
</plugins>
51+
</build>
52+
53+
<dependencies>
54+
<dependency>
55+
<groupId>com.codenameone</groupId>
56+
<artifactId>codenameone-core</artifactId>
57+
<scope>provided</scope>
58+
</dependency>
59+
<dependency>
60+
<groupId>${project.groupId}</groupId>
61+
<artifactId>${cn1app.name}-common</artifactId>
62+
<version>${project.version}</version>
63+
</dependency>
64+
<dependency>
65+
<groupId>${project.groupId}</groupId>
66+
<artifactId>${cn1app.name}-common</artifactId>
67+
<version>${project.version}</version>
68+
<classifier>tests</classifier>
69+
<scope>test</scope>
70+
</dependency>
71+
72+
</dependencies>
73+
74+
<profiles>
75+
<profile>
76+
<id>run-android</id>
77+
<build>
78+
<plugins>
79+
<plugin>
80+
<groupId>org.codehaus.mojo</groupId>
81+
<artifactId>properties-maven-plugin</artifactId>
82+
<version>1.0.0</version>
83+
<executions>
84+
<execution>
85+
<phase>initialize</phase>
86+
<goals>
87+
<goal>read-project-properties</goal>
88+
</goals>
89+
<configuration>
90+
<files>
91+
<file>${basedir}/../common/codenameone_settings.properties</file>
92+
</files>
93+
</configuration>
94+
</execution>
95+
</executions>
96+
</plugin>
97+
98+
<plugin>
99+
<artifactId>maven-antrun-plugin</artifactId>
100+
<executions>
101+
<execution>
102+
<id>adb-install</id>
103+
<phase>verify</phase>
104+
<goals>
105+
<goal>run</goal>
106+
</goals>
107+
<configuration>
108+
<target>
109+
<echo>Running adb install</echo>
110+
<exec executable="${env.ANDROID_HOME}/platform-tools/adb" failonerror="true">
111+
<arg value="install"/>
112+
<arg value="-r"/>
113+
<arg value="${project.build.directory}/${project.build.finalName}.apk"/>
114+
</exec>
115+
116+
<echo>Trying to start app on device using adb</echo>
117+
<exec executable="${env.ANDROID_HOME}/platform-tools/adb" failonerror="true">
118+
<arg value="shell"/>
119+
<arg value="am" />
120+
<arg value="start" />
121+
<arg value="-n" />
122+
<arg value="${codename1.packageName}/.${codename1.mainName}Stub"/>
123+
</exec>
124+
</target>
125+
</configuration>
126+
</execution>
127+
</executions>
128+
</plugin>
129+
</plugins>
130+
</build>
131+
</profile>
132+
</profiles>
133+
134+
</project>

0 commit comments

Comments
 (0)