Difference between revisions of "Setup"

From CSE425S Wiki
Jump to navigation Jump to search
 
(19 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
{{:Coursera Setup}}
 
{{:Coursera Setup}}
  
 +
=Bitbucket=
 +
==accept invite==
 +
The first minute of [[https://wustl.app.box.com/s/34nidhbvvnm60lujl9qzug3x45e8ckb8 this video]] (from CSE 131) shows off how to accept a bitbucket invitation sent to your email.
 +
 +
==access==
 +
choose one of the following paths
 +
===set up app password===
 +
[https://support.atlassian.com/bitbucket-cloud/docs/app-passwords/ set up an app password for bitbucket]
 +
===set up ssh key===
 +
If you already have an ssh key, add your public key to bitbucket.
 +
 +
Otherwise, create a new key and add the public key to bitbucket.
 +
 +
[https://support.atlassian.com/bitbucket-cloud/docs/set-up-an-ssh-key/ set up an ssh key for bitbucket]
 +
 +
 +
=Java=
 +
==Language==
 +
* Download [https://www.oracle.com/java/technologies/downloads/ JDK] (17 or greater)
 +
* Install JDK (17 or greater)
 +
 +
==IDE==
 +
===IntelliJ===
 +
* [https://www.jetbrains.com/idea/download/ Download and Install IntelliJ IDEA Community or Ultimate]
 +
 +
===clone repo===
 +
<!--
 +
<youtube>4KaKieHuD_E</youtube>
 +
 +
Note: in this video I imported into an empty workspace.  If you already have projects in your workspace, you can find Import... from the File Menu in Eclipse.
 +
-->
 
=ML=
 
=ML=
 
==Language: Standard ML of New Jersey==
 
==Language: Standard ML of New Jersey==
Line 12: Line 43:
  
 
===Windows===
 
===Windows===
[http://www.smlnj.org/dist/working/index.html download msi installation]
+
''Summer 2023 Note:'' There seems to be an issue with v110.99.3. 
 +
 
 +
[[http://smlnj.cs.uchicago.edu/dist/working/110.99.2/index.html Download and install v110.99.2]].
 +
 
 +
If you run into trouble, getting as close to Linux as you can is a good idea. 
 +
 
 +
If replacing Windows with Linux is out of the question, [https://gist.github.com/tedz2usa/725307535cb4c336941d13e2e5cf86eb installing the Windows Subsystem for Linux] can often be close enough:
 +
<!-- [http://www.smlnj.org/dist/working/index.html download msi installation] -->
  
<!--
 
===Windows (Option A)===
 
[https://chocolatey.org/packages/smlnj via chocolatey]
 
===Windows (Option B)===
 
[https://www.smlnj.org/install/index.html via msi installation]
 
-->
 
 
===Linux===
 
===Linux===
 
[https://www.smlnj.org/install/index.html via apt-get or yum]
 
[https://www.smlnj.org/install/index.html via apt-get or yum]
  
 
==Editor==
 
==Editor==
 +
'''Alert:''' Emacs is '''NOT''' required or encouraged for this course.
 
===VS Code (Preferred)===
 
===VS Code (Preferred)===
 
* [https://code.visualstudio.com/download Download and Install VS Code]
 
* [https://code.visualstudio.com/download Download and Install VS Code]
Line 35: Line 68:
  
 
[[File:OpenFolder.png|600px]]
 
[[File:OpenFolder.png|600px]]
 
+
<!--
 
===or Sublime Text (Alternate)===
 
===or Sublime Text (Alternate)===
 
* [https://www.sublimetext.com/3 Download and Install Sublime Text]
 
* [https://www.sublimetext.com/3 Download and Install Sublime Text]
 +
-->
  
 
=Racket=
 
=Racket=
Line 44: Line 78:
  
 
=Ruby=
 
=Ruby=
==Language==
+
{{:Ruby_Setup}}
===Mac OSX===
 
====Standard Ruby====
 
Nicely, Ruby ships with the Mac standard installation.  While it may not be the most up to date version, it may be the best option to simply use your default version: /usr/bin/ruby.
 
 
 
====Tk Gem====
 
Sadly, it will not be too surprising if this fails.  Reach out if you experience problems on this front.
 
 
 
<nowiki>sudo gem install tk</nowiki>
 
 
 
====OS Gem====
 
<nowiki>sudo gem install os</nowiki>
 
 
 
====PNG Gem====
 
<nowiki>sudo gem install chunky_png</nowiki>
 
 
 
====[https://brew.sh/ Homebrew]====
 
<nowiki>/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)" </nowiki>
 
 
 
====OpenGL Runtime====
 
<nowiki>sudo brew install glfw</nowiki>
 
 
 
====OpenGL Gem====
 
<nowiki>sudo gem install opengl-bindings</nowiki>
 
 
 
<!--
 
=====Install ActiveTcl 8.5=====
 
[https://www.activestate.com/products/tcl/downloads/ Install ActiveTcl 8.5 (not 8.6) from www.activestate.com]
 
=====Install [https://rvm.io/rvm/install Ruby Version Manager]=====
 
<nowiki>\curl -sSL https://get.rvm.io | bash</nowiki>
 
=====Install Ruby With Tcl and Tk=====
 
<nowiki>rvm reinstall ruby-2.2.3 --with-tcl --with-tk</nowiki>
 
=====Set Ruby Version=====
 
<nowiki>rvm use 2.2.3 --default</nowiki>
 
=====Confirm Version=====
 
<nowiki>ruby --version</nowiki>
 
-->
 
 
 
===Windows===
 
====Ruby Installer====
 
[https://rubyinstaller.org/downloads/ Download From RubyInstaller]
 
 
 
[https://github.com/oneclick/rubyinstaller2/releases/download/RubyInstaller-2.7.2-1/rubyinstaller-devkit-2.7.2-1-x64.exe Ruby+Devkit 2.7.2-1 (x64)]
 
 
 
====Tk Gem====
 
<nowiki>gem install tk</nowiki>
 
 
 
====OS Gem====
 
<nowiki>gem install os</nowiki>
 
 
 
====PNG Gem====
 
<nowiki>gem install chunky_png</nowiki>
 
 
 
====OpenGL Gem====
 
<nowiki>gem install opengl-bindings</nowiki>
 
 
 
====Zip Gem====
 
<nowiki>gem install zip</nowiki>
 
 
 
====OpenGL Runtime====
 
[https://www.transmissionzero.co.uk/files/software/development/GLUT/freeglut-MinGW.zip Download FreeGLUT]
 
 
 
===Linux===
 
====ActiveTcl====
 
Note: you will need to create an account to download ActiveTcl '''8.5'''.
 
 
 
Note: ActiveTcl 8.6 has be known to cause problems.
 
 
 
[https://www.activestate.com/products/tcl/downloads/ Download and Install ActiveTcl '''8.5''']
 
====Ruby Language With Tk====
 
A path that has worked on Ubuntu 20.04:
 
 
 
<nowiki>sudo apt-get install ruby-full</nowiki>
 
 
 
<nowiki>sudo gem install tk -- --with-ActiveTcl</nowiki>
 
 
 
====OS Gem====
 
<nowiki>sudo gem install os</nowiki>
 
 
 
====PNG Gem====
 
<nowiki>sudo gem install chunky_png</nowiki>
 
 
 
====OpenGL Runtime====
 
<nowiki>sudo apt-get update</nowiki>
 
 
 
<nowiki>sudo apt-get install libglu1-mesa-dev freeglut3-dev mesa-common-dev</nowiki>
 
 
 
<nowiki>sudo apt-get install libglfw3-dev</nowiki>
 
 
 
====OpenGL Gem====
 
<nowiki>sudo gem install opengl-bindings</nowiki>
 
 
 
<!-- Does NOT seem to be required for Linux: gem install glfw3-->
 
<!--
 
===Windows===
 
====Via Download====
 
[http://aspn.activestate.com/ASPN/Downloads/ActiveTcl/ ActiveTcl (Includes Tk) Community Edition]
 
====Via Chocolatey====
 
<nowiki>choco install glfw3</nowiki>
 
<nowiki>choco install activetcl</nowiki>
 
 
 
===Linux===
 
====Ubuntu====
 
<nowiki>sudo apt-get update
 
sudo apt-get install libglu1-mesa-dev freeglut3-dev mesa-common-dev
 
sudo apt-get install libglfw3-dev
 
sudo apt-get install libtcltk-ruby</nowiki>
 
 
 
====Fedora====
 
 
 
==Gems==
 
<nowiki>gem install os
 
gem install opengl-bindings
 
gem install glfw3
 
gem install chunky_png
 
gem install launchy
 
gem install tk</nowiki>
 
-->
 
 
 
<!--
 
====Default Installation====
 
Run RubyMine
 
Open Settings
 
Languages & Frameworks
 
Ruby SDK and Gems
 
/usr/bin/ruby
 
-->
 
 
 
==IDE==
 
* [https://www.jetbrains.com/student/ Apply for student status with JetBrains]
 
* [https://www.jetbrains.com/ruby/download/ Download and Install RubyMine]
 
 
 
=Java=
 
==Language==
 
* Download [https://www.oracle.com/technetwork/java/javase/downloads/jdk13-downloads-5672538.html JDK13]
 
* Install JDK13
 
==IDE==
 
===Eclipse===
 
* Download Up To Date Version (2019‑12) of [https://eclipse.org/downloads/ Eclipse]
 
* Install Eclipse (Select '''Eclipse IDE for Java Developers''')
 
===or IntelliJ===
 
* [https://www.jetbrains.com/idea/download/ Download and Install IntelliJ IDEA Community]
 
 
 
=Git Repo=
 
after you have cloned your git repo from bitbucket, be sure to '''import the pom.xml''' file in the top-level java folder.
 

Latest revision as of 15:41, 14 June 2023

Coursera

JoinForFree.jpg
  • do what you need to do to join coursera (and log in, if necessary).
  • click on enroll for free
EnrollForFreeA.png
FullCourseNoCertificate.png

repeat for

Bitbucket

accept invite

The first minute of [this video] (from CSE 131) shows off how to accept a bitbucket invitation sent to your email.

access

choose one of the following paths

set up app password

set up an app password for bitbucket

set up ssh key

If you already have an ssh key, add your public key to bitbucket.

Otherwise, create a new key and add the public key to bitbucket.

set up an ssh key for bitbucket


Java

Language

  • Download JDK (17 or greater)
  • Install JDK (17 or greater)

IDE

IntelliJ

clone repo

ML

Language: Standard ML of New Jersey

Mac OSX

NOTE: recently, macOS 10.15 Catalina switched the default shell from bash to zsh. As a result, you may need to edit .zshenv instead of .bash_profile. You can alternatively switch your default shell in VS Code to bash.

via homebrew

Windows

Summer 2023 Note: There seems to be an issue with v110.99.3.

[Download and install v110.99.2].

If you run into trouble, getting as close to Linux as you can is a good idea.

If replacing Windows with Linux is out of the question, installing the Windows Subsystem for Linux can often be close enough:

Linux

via apt-get or yum

Editor

Alert: Emacs is NOT required or encouraged for this course.

VS Code (Preferred)

Extensions.png

SearchStandardML.png

InstallStandardML.png

OpenFolder.png

Racket

Language and IDE

Ruby

Language

Mac OSX

Note: depending on how the permissions are set up on your machine you may need to prefix a command with sudo or perhaps you may have to omit sudo.

Homebrew

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)" 

Install Ruby

brew install ruby

Add Ruby To Path

if Mac OSX 10.15 Catalina or greater

   ~/.zshrc

else

   ~/.bash_profile

Add this line:

export PATH="/usr/local/opt/ruby/bin:$PATH"

check ruby

You can either

1) restart your terminal

or

2) source the appropriate configuration file based on your shell (which is often dependent on the OSX version)

source .zshrc

or

source .bash_profile

Then run

ruby --version

which should report version 2.7.2 as of Fall 2020.


OS Gem

sudo gem install os

PNG Gem

sudo gem install chunky_png

OpenGL Runtime

The Mac seems to have caused problems with installing OpenGL. Wait for an update on this coming soon.


OpenGL Gem

sudo gem install opengl-bindings

Opener Gem

sudo gem install opener

Windows

Ruby

Download and Install Ruby+Devkit 3.1.2-1 (x64)


OS Gem

gem install os

PNG Gem

gem install chunky_png

OpenGL Gem

gem install opengl-bindings

Zip Gem

gem install zip

OpenGL Runtime

NOTE: the first time you run one of the course's Ruby script which uses OpenGL, it will automatically download and extract FreeGLUT and GLFW3 to your ~/Downloads/CSE425s folder and use the files within.

Opener Gem

gem install opener

Linux

Ruby Language

Fedora

install ruby

Ubuntu
sudo apt-get install ruby-full

OS Gem

sudo gem install os

PNG Gem

sudo gem install chunky_png

OpenGL Runtime

sudo apt-get update
sudo apt-get install libglu1-mesa-dev freeglut3-dev mesa-common-dev
sudo apt-get install libglfw3-dev

OpenGL Gem

sudo gem install opengl-bindings

Opener Gem

sudo gem install opener


IDE

Check Installation

OpenGL

NOTE: Mac users will get an update shortly which should make this process work smoother. No need to test right now.

file to run: src/main/ruby/installation_check/opengl_check.rb Ruby logo.svg

Opengl installation check.png

OpenGL Texture

file to run: src/main/ruby/installation_check/opengl_texture_check.rb Ruby logo.svg

Opengl texture installation check.png