-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathDEVEL.txt
158 lines (128 loc) · 8.22 KB
/
DEVEL.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
Create a github account, and fork the repository
** windows **
Getting the source and contribute changes
Getting Qt
Qt git integration
Getting Dia
Debugging
Building a stand alone program
Building the installer
Deploy to android device
** linux **
Getting the source and contribute changes
Getting Qt
Getting Dia
Debugging
Building a stand alone program
Building the installer
Deploy to android device
================================================
Create a github account, and fork the repository
================================================
Go to github.com, create an account, and login.
Search for CatanScoreboard, and goto the repository.
https://github.com/cdwijs/CatanScoreboard
Next click "fork" at the top-left, then click fork.
Copy the "HTTPS clone URL" line at the right side, it should be something like this:
https://github.com/username/CatanScoreboard.git
===================================================
Getting the source and contribute changes (Windows)
===================================================
Download and install tortoisegit from here:
https://code.google.com/p/tortoisegit/wiki/Download
create a new folder somewhere on your hard disk.
right click the folder, choose "Git Clone..."
paste the "HTTPS clone URL" line into the line "URL:" it should be something like this:
https://github.com/username/CatanScoreboard.git
click OK. the repository is now cloned into the folder on your hard disk.
When you have edited files, right click on the folder, choose commit -> master.
You will be asked to enter information why you made the changes. This information is then stored locally on your computer.
Next, publish the changes you have made to github by rightclick, and push. You will be asked for your github username and password. Now the changes are transferred to your repository on github.
Finally, login to github, navigate to your fork of CatanScoreboard, and click "Pull request", and then click "Create pull request"
Provide a meaningful summary and description, then click "Create pull request". Now the developers are notified of your changes.
====================
Getting Qt (Windows)
====================
http://www.qt.io/download-open-source/
http://download.qt.io/official_releases/online_installers/qt-unified-windows-x86-online.exe
welcome-> next
qt account -> leave all empty, skip
setup -> next
installation folder: c:\qt -> next
select components: qt 5.4, deselect all, select minGW 4.9.1, , and tools-mingw4.9.1 -> next
license Agreement: agree -> next
start menu shortcuts -> next
install
installation finished -> next -> launch
============================
Qt git integration (windows)
============================
Install Git for windows, accept all the defaults except "Use Git from Windows Command Prompt"
https://msysgit.github.io/
Next restart the computer to make sure the PATH variable has been updated. Start cmd.exe and type "path <enter>". "c:\Program Files (x86)\Git\cmd" should be present
=====================
Getting Dia (windows)
=====================
Download and install dia from here, accept the default settings
http://dia-installer.de/
===================
Debugging (windows)
===================
Double-click "CatanScoreborad.pro" Now Qt Creator should start, and load the project. Next click Debug->start debugging->start debugging. (or press F5). Now the program should be compiled, and after some time the program should start to run.
========================================
Building a stand alone program (windows)
========================================
Not written yet
================================
Building the installer (windows)
================================
Not written yet.
See also:
https://wiki.qt.io/Building_Qt_Installers
=================================
Add support for android (windows)
=================================
Run "Qt maintenance tool", skip the Qt Account step, select "Add or remove components, next. You could get the message "There's an important update available, please run the installer first." In this case, restart Qt maintenance tool, skip the Qt Account step, select "Update components", next, select maintenance tool, next, update. Next run "Qt maintenance tool", skip the Qt Account step, select "Add or remove components, next.
Open the Qt version installed, and select "Android x86", "Android armv5" or "Android armv7" depending on your android device. Then press next, and update, and finish.
Run "Qt Creator", goto Tools->options->android, and press the green arrow after JDK location. Then click Java Platform (JDK) 8u60, accept the licence, and download "jdk-8u60-windows-x64.exe", run the installer and accept the defaults. Go back to Qt creator, Tools->options->android, JDK location and browse to C:\Program Files\Java\jdk1.8.0_60
Run "Qt Creator", goto Tools->options->android, and press the green arrow after "Android SDK location" Scroll down to "SDK Tools Only", and download http://dl.google.com/android/installer_r24.3.4-windows.exe. Run the installer, and accept the defaults. Run the androi SDK manager as administrator. In the Android SDK Manager, select "Android SDK Platform-tools, Android SDK Build tools, and extra's Android support library and google USB driver". Also select the android version of your device, and install "SDK platform". Click Install 5 packages, accept the license, and install. Go back to Qt creator, Tools->options->android, Android SDK location, and browse to C:\Program Files (x86)\Android\android-sdk
Run "Qt Creator", goto Tools->options->android, and press the green arrow after "Android NDK location" Click "NDK Documentation and Downloads", and then click "downloads", and download http://dl.google.com/android/ndk/android-ndk-r10e-windows-x86_64.exe. Run the extracter, and point qt to the location of the extracted files.
Run "Qt Creator", goto Tools->options->android, and press the green arrow after Ant Executable. Scroll down, and download http://ftp.tudelft.nl/apache//ant/binaries/apache-ant-1.9.6-bin.zip Unit it somewhere, and in Qt browse to ant.bat
==================================
Deploy to android device (windows)
==================================
Connect your tablet to the PC. Go to the developper options of the tablet, and activate "USB debugging". Open the project in Qt. In the left sidebar, select projects->build&run->Add Kit->Android for armabi-v7a (depending on your tablet), then click the left debug tile with the arrow, and select Android for armabi-v7a. Next press F5 (start debugging) Now a pop-up screen lets you select an android device.
============================================================
Getting the source and contribute changes (ubuntu)
============================================================
Open a terminal, create a folder somewhere on your system and cd into it. Then type the following:
$ git clone https://github.com/username/CatanScoreboard.git The repository is now cloned into the folder on your hard disk.
Double click "CatanScoreboard.pro" Now Qt creator will start, and load the project.
When you have edited files, choose tools->git->local repository->commit. Activate the checkbox [X] files->check all, type a meaningful description of the change, and press commit. This information is then stored locally on your computer.
Next, publish the changes you have made to github. Choose tools->git->Remote Repository->Push You will be asked for your github username and password. Now the changes are transferred to your repository on github.
Finally, login to github, navigate to your fork of CatanScoreboard, and click "Pull request", and then click "Create pull request"
Provide a meaningful summary and description, then click "Create pull request". Now the developers are notified of your changes.
=============================
Getting Qt (linux)
=============================
$ sudo apt-get install qt-sdk
=============================
Getting Dia (linux)
=============================
$ sudo apt-get install dia
=================
Debugging (linux)
=================
Not written yet
======================================
Building a stand alone program (linux)
======================================
Not written yet
==============================
Building the installer (linux)
==============================
Not written yet
================================
Deploy to android device (linux)
================================
Not written yet