Wiki source code of getting-started

Version 35.1 by Gideon Lombard on 2023/09/15 09:39

Hide last authors
Rudi Marais 5.1 1 Hi Team
Rudi Marais 2.1 2
Rudi Marais 5.1 3
Gideon Lombard 34.1 4 When you open the projects from the new locations you might have to fix some of the references due to the folder structures changing ie code is not under a "Development" folder as it now is branch based. This can be done by editing the csproj directly or doing a search and replace with the new paths where applicable, alternatively you can remove the old references via IDE and relink to new paths **do not link to old paths on your machine**​.
Gideon Lombard 31.1 5
Gideon Lombard 35.1 6 **Prerequisites**
Gideon Lombard 31.1 7
Gideon Lombard 35.1 8 1. Install [[WinMerge>>https://winmerge.org/]]
9 1. Install [[Notepad++>>https://notepad-plus-plus.org/]]
10 1. Install [[VisualStudio 2022>>https://visualstudio.microsoft.com/vs/]]
11 1. Install [[VisualStudio Code>>https://code.visualstudio.com/Download]]
12
13 **Source control installation**
14
15 1. Install [[Git for Windows>>doc:technical-documentation.Source Control.client-tools.git-for-windows.WebHome]]
16 1. Install [[tortoisegit>>doc:technical-documentation.Source Control.client-tools.tortoisegit.WebHome]]
17
Gideon Lombard 34.1 18 Some of the projects have been converted to start using our own nuget feed so to ensure you do not have any connectivity issues:
Gideon Lombard 31.1 19
Gideon Lombard 34.1 20 ~1. Make sure that you download and install the latest version of Git from [[https:~~/~~/gitforwindows.org/>>https://gitforwindows.org/]]
Rudi Marais 2.1 21
22
Gideon Lombard 34.1 23 [[image:1657114851784-392.png]]
Rudi Marais 2.1 24
Gideon Lombard 33.1 25
Gideon Lombard 34.1 26 [[image:1657114877100-308.png]]
Gideon Lombard 21.2 27
28
Gideon Lombard 34.1 29 [[image:1657114930282-807.png]]
Gideon Lombard 21.2 30
31
Gideon Lombard 34.1 32 [[image:1657114946064-403.png]]
Gideon Lombard 30.1 33
Gideon Lombard 34.1 34
35
36 [[image:1657114967427-838.png]]
37
38 [[image:1657114979552-688.png]]
39
40
41 [[image:1657114991695-101.png]]
42
43
44 [[image:1657115030668-697.png]]
45
46 [[image:1657115041449-256.png]]
47
48
49 [[image:1657115057201-480.png]]
50
51
52 [[image:1657115066593-304.png]]
53
54
55 [[image:1657115075687-171.png]]
56
57
58 [[image:1657115106191-233.png]]
59
60
61
62
63
Rudi Marais 2.1 64 1. make sure your VS is updated with the latest updates (critical)
65 1. (((
Gideon Lombard 6.2 66 install [[The Azure Artifacts Credential Provider>>url:https://github.com/Microsoft/artifacts-credprovider#setup]] and select the **PowerShell helper script **link
67
Gideon Lombard 10.2 68 [[image:1657111373296-938.png]]
Gideon Lombard 6.2 69
Gideon Lombard 10.2 70 Click the copy icons to copy the text
71
72 [[image:1657111476063-780.png]]
73
74
75 Open Windows Powershell ISE as administrator and click the new button and paste the text in the script window
76
77 [[image:1657111556824-350.png]]
78
79
80 [[image:1657111596157-325.png]]
81
Gideon Lombard 10.3 82 Click the Run button to execute the script
83
Gideon Lombard 10.2 84
Rudi Marais 2.1 85 )))
86 1. (((
Gideon Lombard 10.4 87 For the Visual Studio development users they require to run the following inside a Visual Studio Command Shell as an administrator
Rudi Marais 2.1 88
89 dotnet nuget add source https:~/~/pkgs.dev.azure.com/ebsphere/ebsphere/_packaging/ebs-dev/nuget/v3/index.json ~-~-name ebs-dev
90 )))
91
92 1.
93
94 1.
95
96 Also while we in the transition phase it might be helpful to add this link via this command:
97
98 >mklink /D c:\dev\src\Packages C:\dev\Packages
99
100
Gideon Lombard 29.1 101 [[image:1657115475686-934.png]]
Rudi Marais 2.1 102
Gideon Lombard 29.1 103
104 The URL's for different repositories to clone is as follows:
105
106 ~-~-> Application Source Code
107
108 [[image:1657115603808-846.png]]
109
110
111 [[image:1657115842929-756.png]]
112
Rudi Marais 2.1 113 For reference attached is the mappings of the new folders from old folders.
114
115
116 If you want to start making changes follow the following process:
117
118
119 1. (((
120 Right click the migration folder and create a new branch via the TortoiseGit menu
121
122
Rudi Marais 5.1 123 1. [[image:image-20220706143954-1.png]]
Rudi Marais 2.1 124 )))
125 1. specify branch name follow this pattern for now (names cannot have spaces use dashes -):
126
127 1. feature/il-12345
128 11. if it is issue log related you can add a -short-description if needed
129 11. 12345 = replace with issue log number
130 1. feature/12345
131 11. if it is azure task related
132 11. 12345 = replace with az workitem number
133 1. feature/short-description
134 11. if it has no work item associated to it
135
136 1. make sure you select branch = master and switch to new branch is checked
Rudi Marais 5.1 137 11. [[image:image-20220706143954-2.png]]
Rudi Marais 2.1 138
139 As mentioned Friday if there is a piece of new code that has sync over yet and you need it, merge it over on your end with something like winmerge //once you have created a feature branch//.
140
141
142 As always please reach out if you get stuck.
143
144
Rudi Marais 5.1 145 Regards

Need help?

If you need help with XWiki you can contact: