0% found this document useful (0 votes)
11 views2 pages

CS-2810 Final Project Submission Guide

Uploaded by

Bo Stevens
Copyright
© All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
0% found this document useful (0 votes)
11 views2 pages

CS-2810 Final Project Submission Guide

Uploaded by

Bo Stevens
Copyright
© All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd

CS-2810 Final Project

- Final Submission Checklist

Checkpoint Description
If you’ve made it to this point, you will have written a pretty LARGE amount of code. The final line-count comes down to just a little over
700 lines of code!
Obviously discounting any lines we wrote, then deleted after the fact, as we were building things out.
As such, there is a lot of functionality that our program contains that needs to be checked. Below is a checklist VERY similar to the one that will be
used to grade your final submission. That is to say-

If your code can do EVERYTHING in the checklist


You will VERY LIKELY get a FULL score

1.0 Exporting as .jar


First step is to export your program as a .jar file
Do NOT do this through Eclipse!!!

Eclipse has a tool to export projects to a .jar file. This tool will NOT work for our purposes.
It WILL successfully output a .jar
But this .jar WILL also crash immediately

This is because gradle has split our program up between MULTIPLE projects, that all need to be exported together. The following steps are taken
from the currently existing steps that are posted on Canvas.

It is STRONGLY recommended that you perform these steps on a Windows machine.

Locate your project directory ->


Open desktop folder ->
Right-click -> Open Powershell Window here ->
(Or navigate here using the terminal)

Open up your terminal and type the following command

./gradlew desktop:dist
Your .jar will be located in
-> Desktop -> build -> libs

If you can execute your program from the .jar file you generated, you can move on to the next step

1.1 Push all changes to Github


Your Github repository should contain all of your code from checkpoints 0 through 6. Make sure to push any and all changes out to your repository.
You should see something vaguely like the following-

1.2 Verifying application functionality


Hop back into the assignment, and you should see a video.
Open your program FROM YOUR .jar FILE

If your code performs as showcased, you should be good to go!

Common questions

Powered by AI

Eclipse's tool for exporting to a .jar file is not recommended in this project because it fails to properly compile and package the program when the code is divided across multiple projects. The tool can output a .jar file but it results in a version that crashes immediately because it does not include all necessary dependencies and submodule code required for execution. The project's unique structure requires an alternative method provided by Gradle to ensure all components are correctly included and functional .

Verifying application functionality via a .jar file is significant in the project because it demonstrates that the exported program can perform as expected when run outside of the development environment. This verification step ensures that the program's functionality is preserved through the export process and that users experience the intended performance and features when running the .jar file. It is a critical step in ensuring the application meets the project's requirements for functionality, as showcased in the associated video .

It is recommended to perform the .jar export steps on a Windows machine because the checklist instructions and steps provided are specifically tailored for execution within a Windows environment. The tooling and scripted commands, such as using Powershell to open a terminal and executing Gradle build commands, are designed with Windows compatibility in mind, which ensures a smoother and more controlled export process .

Pushing changes to GitHub improves the collaborative development process by enabling team members to access the most recent code, review changes, and integrate their work seamlessly. It facilitates collaborative editing, version tracking, and conflict resolution. Moreover, it allows for a transparent history of changes which is invaluable for project management and accountability, ensuring that the code repository reflects the latest version of the project across all checkpoints .

Gradle plays a critical role in the build process by automating the compilation and packaging of the program into a .jar file that includes all necessary components across multiple projects. Unlike traditional single-project exports, Gradle manages dependencies, compiles the project, and creates a distribution package that ensures the program runs correctly post-export. Its use allows the project to handle complex build configurations efficiently and ensures that the final output .jar file includes all needed components to execute without errors .

The inclusion of a video in the verification process serves as a benchmark for the expected performance and functionality of the application. By comparing the functionality of the application as exhibited in the .jar file to the video, developers can verify whether the application performs correctly and meets the project's specified requirements. It ensures consistency between what was developed and what is actually delivered, acting as a quality assurance measure .

The primary challenge in exporting a Java program as a .jar file for this project is that the program is split across multiple projects that need to be exported together. Eclipse's tool for exporting to a .jar will not work because it outputs a file that crashes immediately. This issue is resolved by using Gradle, which allows for proper compilation and packaging of the program across the multiple projects. The specific command for this, which should be run in a terminal on a Windows machine, is './gradlew desktop:dist'. This generates a .jar file in the Desktop -> build -> libs directory that can be properly executed .

To successfully export a program using Gradle in this project, the following steps should be followed: First, locate the project directory and open a terminal, preferably a Powershell window on a Windows machine. Then, navigate to the directory containing the Gradle build script and execute the command './gradlew desktop:dist'. This command compiles the program into a .jar file, which is then located in the Desktop -> build -> libs directory. The correct setup ensures that the .jar includes all projects and dependencies, hence it will function correctly when executed .

The project ensures version control and code tracking through the use of GitHub repositories. All code from various development checkpoints (checkpoints 0 through 6) must be pushed to the GitHub repository. This process allows for meticulous tracking of code changes, maintaining a history of modifications, and ensuring that all team members have access to the most current version of the code across all development stages .

The consequences of not verifying the functionality of the application using the .jar file could include the risk of the application not functioning properly when run outside the development environment, user-facing errors, crashes upon startup, or missing features that were assumed to be working. Verification via the .jar file is essential to ensure compatibility and performance in real-world usage, thereby validating the program's readiness for deployment .

You might also like