summaryrefslogtreecommitdiffstats
path: root/plugins/org.yocto.sdk.ide.doc.user
diff options
context:
space:
mode:
Diffstat (limited to 'plugins/org.yocto.sdk.ide.doc.user')
-rw-r--r--plugins/org.yocto.sdk.ide.doc.user/.classpath6
-rw-r--r--plugins/org.yocto.sdk.ide.doc.user/.project28
-rw-r--r--plugins/org.yocto.sdk.ide.doc.user/.settings/org.eclipse.jdt.core.prefs8
-rw-r--r--plugins/org.yocto.sdk.ide.doc.user/META-INF/MANIFEST.MF8
-rw-r--r--plugins/org.yocto.sdk.ide.doc.user/OSGI-INF/l10n/bundle.properties7
-rw-r--r--plugins/org.yocto.sdk.ide.doc.user/build.properties6
-rw-r--r--plugins/org.yocto.sdk.ide.doc.user/cheatsheets/createNewHelloWorldProject.xml222
-rw-r--r--plugins/org.yocto.sdk.ide.doc.user/plugin.xml13
8 files changed, 298 insertions, 0 deletions
diff --git a/plugins/org.yocto.sdk.ide.doc.user/.classpath b/plugins/org.yocto.sdk.ide.doc.user/.classpath
new file mode 100644
index 0000000..bc74aab
--- /dev/null
+++ b/plugins/org.yocto.sdk.ide.doc.user/.classpath
@@ -0,0 +1,6 @@
1<?xml version="1.0" encoding="UTF-8"?>
2<classpath>
3 <classpathentry kind="con" path="org.eclipse.jdt.launching.JRE_CONTAINER/org.eclipse.jdt.internal.debug.ui.launcher.StandardVMType/JavaSE-1.6"/>
4 <classpathentry kind="con" path="org.eclipse.pde.core.requiredPlugins"/>
5 <classpathentry kind="output" path="bin"/>
6</classpath>
diff --git a/plugins/org.yocto.sdk.ide.doc.user/.project b/plugins/org.yocto.sdk.ide.doc.user/.project
new file mode 100644
index 0000000..ccc3e39
--- /dev/null
+++ b/plugins/org.yocto.sdk.ide.doc.user/.project
@@ -0,0 +1,28 @@
1<?xml version="1.0" encoding="UTF-8"?>
2<projectDescription>
3 <name>org.yocto.sdk.ide.doc.user</name>
4 <comment></comment>
5 <projects>
6 </projects>
7 <buildSpec>
8 <buildCommand>
9 <name>org.eclipse.jdt.core.javabuilder</name>
10 <arguments>
11 </arguments>
12 </buildCommand>
13 <buildCommand>
14 <name>org.eclipse.pde.ManifestBuilder</name>
15 <arguments>
16 </arguments>
17 </buildCommand>
18 <buildCommand>
19 <name>org.eclipse.pde.SchemaBuilder</name>
20 <arguments>
21 </arguments>
22 </buildCommand>
23 </buildSpec>
24 <natures>
25 <nature>org.eclipse.pde.PluginNature</nature>
26 <nature>org.eclipse.jdt.core.javanature</nature>
27 </natures>
28</projectDescription>
diff --git a/plugins/org.yocto.sdk.ide.doc.user/.settings/org.eclipse.jdt.core.prefs b/plugins/org.yocto.sdk.ide.doc.user/.settings/org.eclipse.jdt.core.prefs
new file mode 100644
index 0000000..f90fa9c
--- /dev/null
+++ b/plugins/org.yocto.sdk.ide.doc.user/.settings/org.eclipse.jdt.core.prefs
@@ -0,0 +1,8 @@
1#Fri Mar 04 13:59:33 CET 2011
2eclipse.preferences.version=1
3org.eclipse.jdt.core.compiler.codegen.inlineJsrBytecode=enabled
4org.eclipse.jdt.core.compiler.codegen.targetPlatform=1.6
5org.eclipse.jdt.core.compiler.compliance=1.6
6org.eclipse.jdt.core.compiler.problem.assertIdentifier=error
7org.eclipse.jdt.core.compiler.problem.enumIdentifier=error
8org.eclipse.jdt.core.compiler.source=1.6
diff --git a/plugins/org.yocto.sdk.ide.doc.user/META-INF/MANIFEST.MF b/plugins/org.yocto.sdk.ide.doc.user/META-INF/MANIFEST.MF
new file mode 100644
index 0000000..efb0865
--- /dev/null
+++ b/plugins/org.yocto.sdk.ide.doc.user/META-INF/MANIFEST.MF
@@ -0,0 +1,8 @@
1Manifest-Version: 1.0
2Bundle-ManifestVersion: 2
3Bundle-Name: %Bundle-Name
4Bundle-SymbolicName: org.yocto.sdk.ide.doc.user;singleton:=true
5Bundle-Version: 1.4.0.qualifier
6Bundle-Vendor: %Bundle-Vendor
7Bundle-RequiredExecutionEnvironment: JavaSE-1.6
8Require-Bundle: org.eclipse.ui.cheatsheets
diff --git a/plugins/org.yocto.sdk.ide.doc.user/OSGI-INF/l10n/bundle.properties b/plugins/org.yocto.sdk.ide.doc.user/OSGI-INF/l10n/bundle.properties
new file mode 100644
index 0000000..2cf9956
--- /dev/null
+++ b/plugins/org.yocto.sdk.ide.doc.user/OSGI-INF/l10n/bundle.properties
@@ -0,0 +1,7 @@
1#Properties file for org.yocto.sdk.ide.doc.user
2Bundle-Vendor = yoctoproject.org
3Bundle-Name = Yocto User Help
4
5category.name = Yocto Project
6
7cheatsheet.name = Creating a Hello World ANSI C or C++ Autotools Project
diff --git a/plugins/org.yocto.sdk.ide.doc.user/build.properties b/plugins/org.yocto.sdk.ide.doc.user/build.properties
new file mode 100644
index 0000000..caf850b
--- /dev/null
+++ b/plugins/org.yocto.sdk.ide.doc.user/build.properties
@@ -0,0 +1,6 @@
1bin.includes = plugin.xml,\
2 .,\
3 META-INF/,\
4 OSGI-INF/,\
5 cheatsheets/
6src.includes = cheatsheets/
diff --git a/plugins/org.yocto.sdk.ide.doc.user/cheatsheets/createNewHelloWorldProject.xml b/plugins/org.yocto.sdk.ide.doc.user/cheatsheets/createNewHelloWorldProject.xml
new file mode 100644
index 0000000..310dce6
--- /dev/null
+++ b/plugins/org.yocto.sdk.ide.doc.user/cheatsheets/createNewHelloWorldProject.xml
@@ -0,0 +1,222 @@
1<?xml version="1.0" encoding="UTF-8"?>
2<!--
3/*******************************************************************************
4 * Copyright (c) 2012 BMW Car IT GmbH.
5 * All rights reserved. This program and the accompanying materials
6 * are made available under the terms of the Eclipse Public License v1.0
7 * which accompanies this distribution, and is available at
8 * http://www.eclipse.org/legal/epl-v10.html
9 *
10 * Contributors:
11 * Atanas Gegov - initial cheat sheet for creating the hello world project.
12 *******************************************************************************
13-->
14<cheatsheet title="Creating a Hello World ANSI C or C++ Autotools Project">
15 <intro>
16 <description>
17 This cheat sheet will guide you through the process of creating and
18 building a &quot;Hello World ANSI C Autotools Project&quot; or
19 a &quot;Hello World C++ Autotools Project&quot;
20 application that uses a Yocto Project template.
21 </description>
22 </intro>
23 <item title="Open the C/C++ Perspective" dialog="false" skip="true">
24 <description>
25 Select <b>Window</b> &gt; <b>Open Perspective</b> &gt;
26 <b>Other...</b> from the menu bar.<br/>
27 Choose <b>C/C++</b> from the <b>Open Perspective</b> dialog.
28 Click <b>OK</b>.
29 </description>
30 <command
31 required="false"
32 serialization="org.eclipse.ui.perspectives.showPerspective(org.eclipse.ui.perspectives.showPerspective.perspectiveId=org.eclipse.cdt.ui.CPerspective)">
33 </command>
34 </item>
35 <item title="Specify a toolchain and sysroot location" dialog="true" skip="true">
36 <description>
37 You need to specify a toolchain and sysroot location before
38 building any project in the workspace.
39 </description>
40 <subitem>
41 <description>
42 The global settings can be modified in the <b>Yocto Project ADT</b>
43 section of the eclipse preferences. Select <b>Window</b> &gt;
44 <b>Preferences</b> from the menu bar and then select the section
45 <b>Yocto Project ADT</b>. These settings are the default ones for
46 every project you create in the workspace.
47 </description>
48 <command
49 required="false"
50 serialization="org.eclipse.ui.window.preferences(preferencePageId=org.yocto.sdk.ide.preferences.YoctoSDKPreferencePage)">
51 </command>
52 </subitem>
53 <subitem>
54 <description>
55 Choose in the <b>Cross Compiler Options</b> the
56 <b>Standalone pre-built toolchain</b>.
57 </description>
58 </subitem>
59 <subitem>
60 <description>
61 Provide a <b>Toolchain Root Location</b> (e.g.
62 /opt/poky/1.3 or some other location on the filesystem).
63 </description>
64 </subitem>
65 <subitem>
66 <description>
67 Provide a <b>Sysroot Location</b>. This is the filesystem
68 containing libraries, headers etc. used while cross-building
69 binaries for the target.
70 </description>
71 </subitem>
72 <subitem>
73 <description>
74 If more than one toolchain is found in the <b>Toolchain
75 Root Location</b>, use the drop-down box to select the <b>Target
76 Architecture</b>. Make sure that the selected sysroot matches
77 the toolchain.
78 </description>
79 </subitem>
80 <subitem>
81 <description>
82 Choose in the <b>Target Options</b> whether the target is a QEMU
83 emulation (kernel location required) or an external hardware.
84 The target is used for running or remote debugging the binaries
85 created for it.
86 </description>
87 </subitem>
88 <subitem>
89 <description>
90 Save the settings with <b>Apply</b> and <b>OK</b>. You can later
91 change these settings for any project from the menu
92 <b>Project</b> &gt; <b>Change Yocto Project Settings</b>.
93 </description>
94 </subitem>
95 </item>
96 <item title="Choose the programming language for the project" dialog="true">
97 <description>
98 Choose between the available &quot;Hello World ANSI C Autotools
99 Project&quot; or the &quot;Hello World C++ Autotools Project&quot;
100 template projects.
101 </description>
102 <command returns="progLanguage"
103 serialization="org.eclipse.ui.dialogs.openMessageDialog(title=Select Programming Language,buttonLabel0=C++,message=Select the programming language for the Hello World Autotools Project project,buttonLabel1=C)"/>
104 <onCompletion> You selected ${progLanguage}.</onCompletion>
105 </item>
106 <item title="Create a Hello World Autotools Project">
107 <description>
108 Create a Yocto Project ADT Project &quot;Hello World ANSI C Autotools
109 Project&quot; or &quot;Hello World C++ Autotools Project&quot;
110 by using the appropriate Project wizard.
111 </description>
112 <conditional-subitem condition="${progLanguage}">
113 <subitem when="C++">
114 <description>
115 Click <b>File</b> &gt; <b>New</b> &gt; <b>C++ Project</b> to
116 launch the C++ Project wizard.
117 </description>
118 <command
119 required="false"
120 serialization="org.eclipse.ui.newWizard(newWizardId=org.eclipse.cdt.ui.wizards.NewCWizard1)">
121 </command>
122 </subitem>
123 <subitem when="C">
124 <description>
125 Click <b>File</b> &gt; <b>New</b> &gt; <b>C Project</b> to
126 launch the C Project wizard.
127 </description>
128 <command
129 required="false"
130 serialization="org.eclipse.ui.newWizard(newWizardId=org.eclipse.cdt.ui.wizards.NewCWizard2)">
131 </command>
132 </subitem>
133 </conditional-subitem>
134 <conditional-subitem condition="${progLanguage}">
135 <subitem when="C++">
136 <description>
137 Enter <b>HelloWorld</b> as the project name, then select
138 <b>Yocto Project ADT Project</b> &gt;
139 <b>Hello World C++ Autotools Project</b> from the Project type
140 list and click <b>Next</b>.
141 </description>
142 </subitem>
143 <subitem when="C">
144 <description>
145 Enter <b>HelloWorld</b> as the project name, then select
146 <b>Yocto Project ADT Project</b> &gt;
147 <b>Hello World ANSI C Autotools Project</b> from the Project type
148 list and click <b>Next</b>.
149 </description>
150 </subitem>
151 </conditional-subitem>
152 <subitem skip="true">
153 <description>
154 Fill in the name of the <b>Author</b>. Make some changes in the
155 other fields if needed. Possibly change the <b>License</b> from
156 the drop-down box and click <b>Next</b>.
157 </description>
158 </subitem>
159 <subitem skip="true">
160 <description>
161 If needed make some Advanced settings. Confirm them with
162 <b>Apply</b> and <b>OK</b>.
163 </description>
164 </subitem>
165 <subitem>
166 <description>
167 Click <b>Finish</b> to create the project in your workspace. You
168 will find the created project in the <b>Project Explorer</b> view.
169 </description>
170 </subitem>
171 </item>
172 <item title="Build the project" dialog="true">
173 <description>
174 Create the project&apos;s binary using a specified toolchain and
175 sysroot.
176 </description>
177 <subitem>
178 <description>
179 Make sure that the project is on focus in the
180 <b>Project Explorer</b> view.
181 </description>
182 </subitem>
183 <subitem>
184 <description>
185 If you want to change the default settings for toolchain and
186 sysroot location go to <b>Project</b> &gt;
187 <b>Change Yocto Project Settings</b> in the menu bar. Finish the
188 editing by pressing <b>OK</b>.
189 </description>
190 </subitem>
191 <subitem>
192 <description>
193 If you have changed the settings in the previous step, call
194 <b>Project</b> &gt; <b>Reconfigure Project</b> to reconfigure the
195 project with these new settings (e.g. create the correct Makefiles
196 that make use of the selected toolchain and sysroot).
197 </description>
198 </subitem>
199 <subitem>
200 <description>
201 Build the project with a click on the hammer symbol in the
202 Toolbar. Alternatively, go to <b>Project</b> &gt;
203 <b>Build Project</b>. If you didn&apos;t change the default
204 toolchain and sysroot, now the configuring step will be executed
205 at first, followed by the build step itself.
206 </description>
207 </subitem>
208 <subitem>
209 <description>
210 Observe the output in the different consoles (e.g.
211 <b>Configure [HelloWorld]</b> and
212 <b>CDT Build Console [HelloWorld]</b>) to check if everything
213 was successful.
214 </description>
215 </subitem>
216 <onCompletion>
217 Congratulations, you have completed this cheat sheet! You may
218 continue with editing, rebuilding or debugging the
219 Hello World Autotools Project.
220 </onCompletion>
221 </item>
222</cheatsheet>
diff --git a/plugins/org.yocto.sdk.ide.doc.user/plugin.xml b/plugins/org.yocto.sdk.ide.doc.user/plugin.xml
new file mode 100644
index 0000000..24c539d
--- /dev/null
+++ b/plugins/org.yocto.sdk.ide.doc.user/plugin.xml
@@ -0,0 +1,13 @@
1<?xml version="1.0" encoding="UTF-8"?>
2<?eclipse version="3.4"?>
3<plugin>
4 <extension point="org.eclipse.ui.cheatsheets.cheatSheetContent">
5 <category id="org.yocto.sdk.ide.doc.user.cheatsheets" name="%category.name">
6 </category>
7 <cheatsheet category="org.yocto.sdk.ide.doc.user.cheatsheets"
8 composite="false" contentFile="cheatsheets/createNewHelloWorldProject.xml"
9 id="org.yocto.sdk.ide.doc.user.cheatsheet.helloworldProject"
10 name="%cheatsheet.name">
11 </cheatsheet>
12 </extension>
13</plugin>