Difference between revisions of "VS Code"

From CSE330 Wiki
Jump to navigationJump to search
 
(14 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 
== Getting Started With Each Module ==
 
== Getting Started With Each Module ==
  
# Create Bitbucket repo using the CSE 330 repo creator  (Check Piazza for the link)
+
* Create Github repo using the CSE 330 repo creator  (Check Piazza for the link)
# Navigate to the created repo in Bitbucket
+
* Navigate to the created repo in Github
# Clone the repo via https to a dedicated folder on your computer
+
* Clone the repo via https to a dedicated folder on your computer
  
 
[[File:File-Structure.png|400px|center]]
 
[[File:File-Structure.png|400px|center]]
  
# In VS Code, File > Open the Spring2019-module1-individual-STUDENTID '''folder''' that you cloned to your computer
+
* In VS Code, File > Open the Spring2019-module1-individual-STUDENTID '''folder''' that you cloned to your computer
  
If you followed the above steps correctly, the folder's Git should be configured to your Bitbucket repository!  I highly recommend creating your bitbucket repo, cloning the folder to a designated spot, and keeping all modules separated for the semester as shown in the image above.
+
If you followed the above steps correctly, the folder's Git should be configured to your Github repository!  I highly recommend creating your Github repo, cloning the folder to a designated spot, and keeping all modules separated for the semester as shown in the image above.
  
 
== Module 1 -- Using the Git Integration ==
 
== Module 1 -- Using the Git Integration ==
Line 18: Line 18:
 
* Ensure VS Code has it marked as an html file (see the file type next to the smiley face)
 
* Ensure VS Code has it marked as an html file (see the file type next to the smiley face)
 
* Type '''doc''' followed by enter, and allow VS Code to generate a basic HTML file for you (use VS Code to your advantage! It can do a lot of your coding for you).
 
* Type '''doc''' followed by enter, and allow VS Code to generate a basic HTML file for you (use VS Code to your advantage! It can do a lot of your coding for you).
* Save the file, you should see a popup next to the Version Control symbol on the left. VS Code has detected that your project is different than what it is in your remote Bitbucket repo.
+
* Save the file, you should see a popup next to the Version Control symbol on the left. VS Code has detected that your project is different than what it is in your remote Github repo.
* To commit, simply type a message in the box and click the check mark above it.  To push to your bitbucket repo, click the 3 dots next to the check mark and select 'push'
+
* To commit, simply type a message in the box and click the check mark above it.  To push to your Github repo, click the 3 dots next to the check mark and select 'push'
 
* Note this is also where you can pull from your remote.
 
* Note this is also where you can pull from your remote.
  
 
==== Bonus - Module 1 ====
 
==== Bonus - Module 1 ====
# If you like your text editor to look pretty, you can go to the Extensions tab and search for different themes. (Check out the Material theme!)
+
* If you like your text editor to look pretty, you can go to the Extensions tab and search for different themes. (Check out the Material theme!)
# You can view your settings by clicking CMD + , (Mac) or Ctrl + , (Windows).  Search for Theme and choose one that works for you!
+
* You can view your settings by clicking CMD + , (Mac) or Ctrl + , (Windows).  Search for Theme and choose one that works for you!
  
 
== Module 2 ==  
 
== Module 2 ==  
 +
=== DISCLAIMER ===
 +
{{RequiredInstructions|content=
 +
 +
<span style="color:red">There are two SFTP VSCode extensions of the same name. One of them is depreciated. Use the extension distributed by Natizyskunk.</span>
 +
 +
}}
 +
 
=== SFTP Integration (Shipping files to your server) ===
 
=== SFTP Integration (Shipping files to your server) ===
# Open the Extensions tab and search for 'sftp'. Download the first one.
+
# Select a folder to use for your work and open it in VSCode. When editing files on your instance, the file will be saved locally in this location for editing and reuploaded
 +
# Open the Extensions tab and search for 'SFTP'. Download the version distributed by "Natizyskunk".
 
# To use commands in VS Code, type '''Cmd + Shift + P''' (Mac), or '''Ctrl + Shift + P''' on windows.  
 
# To use commands in VS Code, type '''Cmd + Shift + P''' (Mac), or '''Ctrl + Shift + P''' on windows.  
#Type SFTP and open the sftp config command.  
+
# Type SFTP and open the sftp config command.  
  
Your config should look like the following:
+
Your sftp.json file should look like the following:
 
   {
 
   {
 +
    "name": "<My Instance>",
 +
    "host": "<ec2-xxxxx-xxxxxx-xxxxx.amazonaws.com>",
 
     "protocol": "sftp",
 
     "protocol": "sftp",
    "host": "YOUR.EC2.DNS",
 
 
     "port": 22,
 
     "port": 22,
     "username": "YOUR USERNAME",
+
     "username": "<custom instance username>"
     "privateKeyPath": "/path/to/your/id_rsa",
+
     "remotePath: "/home/<custom instance username>/",
     "remotePath": "/home/YOUR USERNAME/module2",
+
     "uploadOnSave": true,
     "uploadOnSave": true
+
     "privateKeyPath": "</path/to/.ssh/id_rsa>"
 
   }
 
   }
 
- Note the uploadOnSave field is optional, but can be nice!
 
- Note the uploadOnSave field is optional, but can be nice!
 
- Check the VS Code output for errors in your config.
 
- Check the VS Code output for errors in your config.
  
Additionally: You should notice an SFTP tab on the side of VS Code. Here, you can view the file structure on your server.
+
Additionally: You should notice an SFTP tab on the side of VS Code. Here, you can view the file structure on your server.]
 +
 
 +
 
 +
'''Preventing "Edit in Local" when editing files'''
 +
 
 +
In order to edit locally, you'll have to right click on the file you wish to edit and select "Edit in local" every time. To avoid this, you can:
 +
# Open vscode settings by File >> Preferences >> Settings
 +
# In settings, search for "downloadWhenOpenInRemoteExplorer" and toggle it on
 +
# restart VScode.
  
 
=== Testing Everything Locally ===
 
=== Testing Everything Locally ===
If you get the SFTP integration working well, you don't need to set up a local php server.  If you can't get the above working, however, we highly recommend coding all of your projects locally, and only uploading them to your ec2 instance when complete.
+
If you would like to avoid having to frequently upload your changes to your instance in order to test your changes, you can optionally set up a local PHP server.
  
 
'''To run PHP locally'''
 
'''To run PHP locally'''
  
 
'''Windows'''
 
'''Windows'''
# Download WAMP (https://sourceforge.net/projects/wampserver/)
+
# Download WAMP http://www.wampserver.com/en/download-wampserver-64bits/
 
# Place your project repositories in Wamp's www/ directory, and navigate to http://localhost in your browser.  You should see your projects listed here, run php files, and use phpmyadmin.
 
# Place your project repositories in Wamp's www/ directory, and navigate to http://localhost in your browser.  You should see your projects listed here, run php files, and use phpmyadmin.
  
 
'''Mac'''
 
'''Mac'''
 
# Download Homebrew. Homebrew is a great package manager for OSx and we will be using it in future modules.  
 
# Download Homebrew. Homebrew is a great package manager for OSx and we will be using it in future modules.  
# Type the following in your terminal and follow instructions  
+
# Type the following in your terminal and follow instructions
  /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
+
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
 
# In your terminal, type '''php -v'''. If your version is less than 7, update with brew. '''brew install php'''
 
# In your terminal, type '''php -v'''. If your version is less than 7, update with brew. '''brew install php'''
 
# In VS Code, search for the extension '''Php Server'''. After installing, use VS Code's command pallette with CMD+Shift+P , search for PHP, and select start server.  You should be able to view your project in your localhost
 
# In VS Code, search for the extension '''Php Server'''. After installing, use VS Code's command pallette with CMD+Shift+P , search for PHP, and select start server.  You should be able to view your project in your localhost

Latest revision as of 20:08, 27 January 2023

Getting Started With Each Module

  • Create Github repo using the CSE 330 repo creator (Check Piazza for the link)
  • Navigate to the created repo in Github
  • Clone the repo via https to a dedicated folder on your computer
File-Structure.png
  • In VS Code, File > Open the Spring2019-module1-individual-STUDENTID folder that you cloned to your computer

If you followed the above steps correctly, the folder's Git should be configured to your Github repository! I highly recommend creating your Github repo, cloning the folder to a designated spot, and keeping all modules separated for the semester as shown in the image above.

Module 1 -- Using the Git Integration

Note: If you're using Windows, you may need to install Git on your machine first. https://git-scm.com/download/win . You can check if you have Git running by typing git --version in your terminal

  • First, open the File Explorer tab on the left, and right click to create a new file, birthday.html
New-file.png
  • Ensure VS Code has it marked as an html file (see the file type next to the smiley face)
  • Type doc followed by enter, and allow VS Code to generate a basic HTML file for you (use VS Code to your advantage! It can do a lot of your coding for you).
  • Save the file, you should see a popup next to the Version Control symbol on the left. VS Code has detected that your project is different than what it is in your remote Github repo.
  • To commit, simply type a message in the box and click the check mark above it. To push to your Github repo, click the 3 dots next to the check mark and select 'push'
  • Note this is also where you can pull from your remote.

Bonus - Module 1

  • If you like your text editor to look pretty, you can go to the Extensions tab and search for different themes. (Check out the Material theme!)
  • You can view your settings by clicking CMD + , (Mac) or Ctrl + , (Windows). Search for Theme and choose one that works for you!

Module 2

DISCLAIMER

There are two SFTP VSCode extensions of the same name. One of them is depreciated. Use the extension distributed by Natizyskunk.

SFTP Integration (Shipping files to your server)

  1. Select a folder to use for your work and open it in VSCode. When editing files on your instance, the file will be saved locally in this location for editing and reuploaded
  2. Open the Extensions tab and search for 'SFTP'. Download the version distributed by "Natizyskunk".
  3. To use commands in VS Code, type Cmd + Shift + P (Mac), or Ctrl + Shift + P on windows.
  4. Type SFTP and open the sftp config command.

Your sftp.json file should look like the following:

 {
   "name": "<My Instance>",
   "host": "<ec2-xxxxx-xxxxxx-xxxxx.amazonaws.com>",
   "protocol": "sftp",
   "port": 22,
   "username": "<custom instance username>"
   "remotePath: "/home/<custom instance username>/",
   "uploadOnSave": true,
   "privateKeyPath": "</path/to/.ssh/id_rsa>"
 }

- Note the uploadOnSave field is optional, but can be nice! - Check the VS Code output for errors in your config.

Additionally: You should notice an SFTP tab on the side of VS Code. Here, you can view the file structure on your server.]


Preventing "Edit in Local" when editing files

In order to edit locally, you'll have to right click on the file you wish to edit and select "Edit in local" every time. To avoid this, you can:

  1. Open vscode settings by File >> Preferences >> Settings
  2. In settings, search for "downloadWhenOpenInRemoteExplorer" and toggle it on
  3. restart VScode.

Testing Everything Locally

If you would like to avoid having to frequently upload your changes to your instance in order to test your changes, you can optionally set up a local PHP server.

To run PHP locally

Windows

  1. Download WAMP http://www.wampserver.com/en/download-wampserver-64bits/
  2. Place your project repositories in Wamp's www/ directory, and navigate to http://localhost in your browser. You should see your projects listed here, run php files, and use phpmyadmin.

Mac

  1. Download Homebrew. Homebrew is a great package manager for OSx and we will be using it in future modules.
  2. Type the following in your terminal and follow instructions
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
  1. In your terminal, type php -v. If your version is less than 7, update with brew. brew install php
  2. In VS Code, search for the extension Php Server. After installing, use VS Code's command pallette with CMD+Shift+P , search for PHP, and select start server. You should be able to view your project in your localhost