Skip to content

MacOS

Jump to bottom
Aaron K Redshaw edited this page Jun 29, 2019 · 6 revisions

Welcome to the DebtPayoff wiki!

This wiki is for beginners. If you are not used to compiling and running a java program, this wiki will get you up and running. By the end, you should be able to run DebtPayoff from any platform.

Chose your platform:

MacOS (this page) / Windows / Linux

Contents:

  • How do I install Java?
  • How do I download DebtPayoff?
  • How do I compile DebtPayoff?
  • How do I run DebtPayoff?

How do I install Java?

In order to compile and run a Java program, you must first install the JDK (Java Development Kit). Follow the steps below.

  1. Download the JDK from Oracle to your computer. (Java SE means standard edition. This is what you will use.)
  2. Install it by double clicking on the download (with a .dmg extension). This will lead you through the installation to your computer.
  3. You will need to type your administrative user name and password.

Java is now installed.

How do I download DebtPayoff?

Really, there are two main ways you can download the source code for this program: The easy way and the developer's way. I will show you both.

The easy way

  1. In a web browser, go to https://github.com/aredshaw/DebtPayoff/tree/master/src.
  2. Right-click on DebtPayoff.java and select Save link as...
  3. Select where you want to save the code and click Save.

The developer's way

For this you will use git

  1. Download git for windows.
  1. Install git by double clicking your download.
  2. Open a terminal: Open the Applications folder
  • Open the Utilities folder
  • Double-click on the Terminal application
  1. Navigate to where you want to save your files. For a handy sheet on Windows command prompt, there is a good cheat sheet here.
  2. In your web browser go to https://github.com/aredshaw/DebtPayoff. (Create a GitHub account if you have not done this yet.) Then at the top right of the DebtPayoff page, click on Fork.
  3. On that same page just below that click on Clone or Download and then click on the clipboard icon to the right of the URL (web address). I circled where you should click in red.

Clone or Download-Clipboard

  1. Go back to your command prompt and type:
git clone {use CTRL-V here to paste the URL}.

It may look something like this:

git clone https://github.com/aredshaw/DebtPayoff.git

The whole project is now downloaded to your computer.

How do I compile DebtPayoff?

  1. In the command prompt go into the DebtPayoff directory
  2. type: cd DebtPayoff
  3. Inside this directory type: javac DebtPayoff.java and hit enter

If it compiles correctly, just type java Debtpayoff and the program will start.

Clone this wiki locally