On Windows, you'll need Cygwin, a Java JDK, and ant.
Cygwin is downloadable from http://www.cygwin.com/ or specifically: http://www.cygwin.com/setup-x86.exe (32-bit windows) or http://www.cygwin.com/setup-x86_64.exe (64-bit windows) or http://www.redhat.com/services/custom/cygwin/ (if the Cygwin official site is not OK for us!)
In the Cygwin setup configuration select the packages:
Included in the defaults, but make sure:
Not required but useful:
When the Cygwin setup says it cannot find all packages, clicking "previous" and "next" again will automatically select some additional required packages and often resolves this issue.
Download and install ant. Add the apache-ant-xxx\bin
directory to your path. Ensure that the path to the apache-ant-xxx
directory does not contain quotes (either ' or ") for reasons mentioned here.
Download and install a Java JDK.
Point the JAVA_HOME
environment variable to the JDK root directory. An error message that reads "Unable to locate tools.jar. Expected to find it in C:\Program Files\Java\jre6\lib\tools.jar" means you need to set JAVA_HOME to your JDK (not JRE) installation.
When building on a 64 bit version of Windows, you must still use the 32 bit JDK. If you have both the 32 and 64 bit JDK's installed, ensure JAVA_HOME
is set to the 32 bit version.
On Mac OS X (using Homebrew, first brew update
), install:
brew install git
)brew tap homebrew/cask-versions
brew cask install adoptopenjdk8
export JAVA_HOME=/Library/Java/JavaVirtualMachines/adoptopenjdk-8.jdk/Contents/Home
brew install ant
)On Linux, you need the Java SDK, avr-gcc, avr-g++, avr-libc, make, ant, git and unzip.
sudo apt-get install git make gcc ant openjdk-8-jdk unzip
If your Linux version is Ubuntu 14.04 and later, you can use the above command line. If not, use the info at http://ubuntuhandbook.org/index.php/2015/01/install-openjdk-8-ubuntu-14-04-12-04-lts/
You may also need the openjfx library to build version 1.8.8:
sudo apt-get install openjfx
sudo pacman -S jdk8-openjdk jre8-openjdk apache-ant git base-devel
rpm -qa --qf "%{name}\n" git make gcc xz-lzma-compat ant \*openjdk\* | sort
ant
gcc
git
java-1.8.0-openjdk
java-1.8.0-openjdk-devel
java-1.8.0-openjdk-headless
xz-lzma-compat
make
and install any packages needed, thus:
sudo yum -y install make gcc ant xz-lzma-compat java-1.8.0-openjdk
N.B.: 'ant' pulls in the '-devel' version of 'java-1.8.0-openjdk' which is expected
This grabs the code from GitHub as an anonymous user.
Make sure your git line ending setting autocrlf
is set to input
or false
. With true
building will fail. You can see/change this setting with:
git config --global --edit [user] name = xxx email = xxx@users.noreply.github.com [core] autocrlf = input [push] default = current
git clone --depth 1 https://github.com/arduino/Arduino.git
(Note: This only pulls the latest commit to make the download faster. The download size of the entire repository is greater than 1GB and might hog all your bandwidth for a long while if your download speed is slow, such as a dialup connection or anything below 8mbps.)
Use the command line:
(Note: cd the path to build folder. Do not copy what is written next to the cd below.)
cd /path/to/arduino/build ant dist
This will prompt you to enter an Arduino version to build (the latest development version will be listed in the prompt, i.e. 1.8.13) before it starts the build.
If everything went well, you'll have no errors. (Feel free to make edits of things to include here for common problems.)
(ant run will call build
and start
)
Updating to the Latest VersionEach time you make a change, use
ant dist
to build the thing andant run
to get it up and running.
Each time you want to update to latest version from git use:
cd /path/to/arduino git pull
If new folders have been added, or you're getting odd errors, use:
The best way to use it is to just make a clean build every time:
If you want to debug the avr core you can put a symlink from your sketchbook to your git folder. This way you can directly commit the changes without copying back and forth.
ln -s ~/Documents/Arduino/Arduino/hardware/arduino/avr/ ~/Documents/Arduino/sketchbook/hardware/arduino/avr
Build for other platforms
You can do the build for other platforms using:
ant clean dist -Dplatform=windows ant clean dist -Dplatform=macosx ant clean dist -Dplatform=macosx-java-latest
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4