Github and IntelliJ

Please follow the directions below EXACTLY to complete this recitation successfully.

1. If you do not have a GitHub account, head over to https://github.com and sign up for an account.

2. If you have not installed IntelliJ, go to IntelliJ Download and download and install the IntelliJ IDE Community Edition. This is the free version of the IDE.

3. Click on Recitation 0 Repo. Click on the Use this template button. This will make a copy of your instructor's repo on your account.
4. You should now see your repository with a green Code button on the top right, as shown in the image below.

   

5. You will now need to create a GitHub authentication token to be used in IntelliJ. Click on your avatar on the top right of the screen. You should see a drop-down menu, as shown in the image below. Select Settings.

   

6. On the Settings page, click on the Developer Setting menu item on the left as shown below.

   

7. Select the Personal Access Tokens as shown in the image below. Make sure to select Tokens (Classic).

   

8. Click the Generate new token button and select the classic option again.
9. Enter General Access in the Note textbox and select the repo, workflow, gist, and read:org checkboxes as shown in the image below. Also, for the expiration, select custom and enter May 31, 2023. This will make your token valid for the entire semester.

   

   <image src="./Instructions/xstep9-2.png" width="430px"style="margin-left:115px;">

10. Click the green Generate Token button at the bottom of the screen.
11. Copy the token by clicking on the copy button, as indicated in the image below. You should store the token somewhere because you cannot recover it. If you should forget it, you will need to regenerate a new token. If you should forget it, you will need to regenerate a new token.

    

12. Now, open up IntelliJ and click on Customize and then All Settings as shown in the image below.

    

13. Expand the Version Control item on the left of the window and select GitHub. Then click on the + as shown in the image below.

    

14. Select the Login with Token, paste your token in the Token textbox, and click the Add Account button, as shown in the image below.

    

15. Now, go back to YOUR repo and click the green Code button and then copy the URL by clicking on the copy button as indicated in the image below.

    

16. Open up IntelliJ and use the Get from VCS button to clone the repository.

    

17. Paste the assignment repository URL in the URL field and make sure to select the directory in which the assignment will sit. IntelliJ will add the name of the repo to the Directory path. If it does not, please add the name of the assignment directory. For example, if the directory is C:\Users\JohnSmith\Documents, make sure to add the name of the assignment. In my case, this should be changed to C:\Users\JohnSmith\Documents\recitation0
    Click the link to download and install Git, if asked.

    WARNING: If you do not add a folder name, IntelliJ will put all the project files in the Documents folder.

18. Press the Clone button. IntelliJ will create the folder for you and place the assignment code in the csci-1210Recitation0 folder under the Documents folder.
19. Your workspace should now look like the image shown below.

    

20. Now, to run and test the provided Java code, you will need to create a run configuration. Click on the run configuration button, as shown in the image below.

    

21. Select Add New Configuration and then select Gradle from the menu as shown in the image below.

    

22. Give the configuration a name, for example Recitation0 Test, and type test in the run textbox, then click OK to complete the run configuration.

    

23. Now press the green play button and notice that the test will fail.

    

24. Open the Recitation0.java file under src/main/java. Add "Hello World!" so that the following line of code reads System.out.println("Hello World"); and then run the test again by clicking on the green play button. You should now see that the test succeeds!
25. You now need to commit the changes you made and push the changes to your repository on Github. Select the Commit tab as shown in the image below.

    

26. Select all the files that have changed and type a message in the text box as shown in the image. The message should summarize the work done then, and click the commit and push button.

    

27. Click the push button in the next window to complete the submission.

    

Congratulations! You now have completed your first Java assignment!