From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mga02.intel.com (mga02.intel.com [134.134.136.20]) by mx.groups.io with SMTP id smtpd.web12.585.1586219998854604470 for ; Mon, 06 Apr 2020 17:39:59 -0700 Authentication-Results: mx.groups.io; dkim=missing; spf=pass (domain: intel.com, ip: 134.134.136.20, mailfrom: nathaniel.l.desimone@intel.com) IronPort-SDR: mzFj7N7MY/CDGLqTz1EBXwVaNVDESNPT1rFvlAXOmOxHvmD4N/j1AqVFbYXBaYj18aRmJyhzIr Nr+M88yWAJhw== X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from orsmga003.jf.intel.com ([10.7.209.27]) by orsmga101.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 06 Apr 2020 17:39:57 -0700 IronPort-SDR: /jW+QNkvcQ5ETXcfP7E8XcwlIsrIOANplBYiCQ3UDU/PI4FqqsJenHGjeY42Sjy9qbrA82GG92 hIlGwH30/Mfw== X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.72,352,1580803200"; d="scan'208";a="251059377" Received: from vbuzyanx-mobl.amr.corp.intel.com ([10.254.111.95]) by orsmga003.jf.intel.com with ESMTP; 06 Apr 2020 17:39:57 -0700 From: "Nate DeSimone" To: devel@edk2.groups.io Cc: Puja Pandya , Erik Bjorge , Prince Agyeman , Bret Barkelew , Philippe Mathieu-Daude Subject: [edk2-staging/EdkRepo] [PATCH 2/2] EdkRepo: Update README.md Date: Mon, 6 Apr 2020 17:39:50 -0700 Message-Id: <20200407003950.33249-3-nathaniel.l.desimone@intel.com> X-Mailer: git-send-email 2.25.2 In-Reply-To: <20200407003950.33249-1-nathaniel.l.desimone@intel.com> References: <20200407003950.33249-1-nathaniel.l.desimone@intel.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit - Added installation instructions for macOS - Updated recommended versions of Git and Python Signed-off-by: Nate DeSimone Cc: Puja Pandya Cc: Erik Bjorge Cc: Prince Agyeman Cc: Bret Barkelew Cc: Philippe Mathieu-Daude --- README.md | 81 +++++++++++++++++++++++++++++++++++++++++++++++++++---- 1 file changed, 76 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 1fbb698..9b02e4c 100644 --- a/README.md +++ b/README.md @@ -47,25 +47,96 @@ To build a EdkRepo distribution tarball, the Python wheel package is required in 2. `./build_linux_installer.py` ### Install From Source -To install from source, one must have installedd using the tarball method above at least once in order to setup the EdkRepo configuration files. One this is done, one may use the standard distutils method to install EdkRepo from source: +To install from source, one must have installed using the tarball method above at least once in order to setup the EdkRepo configuration files. One this is done, one may use the standard distutils method to install EdkRepo from source: `./setup.py install` +## macOS Instructions + +### Install Pre-Requisites + +#### 1. Install the Xcode Command Line Tools + +a) Open a Terminal and type the following command: + +`xcode-select --install` + +b) A new window will appear, click Install. +c) Accept the license agreement. +d) Wait for the installation to complete. + +#### 2. Install Homebrew + +Install [Homebrew](https://brew.sh/) if it has not been installed already. Homebrew is a package manager for macOS that has become the most common method of installing command line software on macOS that was not originally provided by Apple. EdkRepo has several dependencies that are distributed via Homebrew. + +Type the following command to install Homebrew: + +`/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"` + +Follow the on-screen prompts. + +#### 3. Install Dependencies + +Run the following commands to install EdkRepo's dependencies: + +`brew install bash-completion git git-gui pyenv` + +`pyenv install 3.8.2` + +`pyenv global 3.8.2` + +During installation, you may be prompted to enter your password. + +#### 4. Configure Shell for Pyenv and Git + +To enable usage of Pyenv installed Python interpreters and Git command completions, run the following command: + +`/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/tianocore/edk2-staging/EdkRepo/edkrepo_installer/mac-scripts/setup_git_pyenv_mac.sh)"` + +Restart your shell so the Pyenv changes can take effect: + +`exec $SHELL` + +### Install EdkRepo + +Extract the archive: + +`tar -xzvf edkrepo-.tar.gz` + +If you are installing from source, you will need to build the distribution tarball using the following commands first: + +1. `pip install wheel` (If not done already) +1. `cd build-scripts` +2. `./build_linux_installer.py` + +Install EdkRepo: + +`./install.py` + +Restart your shell so the new Pyenv shim for EdkRepo can take effect: + +`exec $SHELL` + ## Windows Instructions ### Pre-Requisites - Git 2.13.x or later - Python 3.5 or later -Git 2.16.2 is the version that has recieved the most validation, though any version of Git 2.13 or later works fine. If you want to install 2.16.2, here are some links: -- [Direct Link - Git for Windows 2.16.2 - 64 Bit](https://github.com/git-for-windows/git/releases/download/v2.16.2.windows.1/Git-2.16.2-64-bit.exe) -- [Direct Link - Git for Windows 2.16.2 - 32 Bit](https://github.com/git-for-windows/git/releases/download/v2.16.2.windows.1/Git-2.16.2-64-bit.exe) +Git 2.26.0 is the version that has received the most validation, though any version of Git 2.13 or later works fine. If you want to install 2.26.0, here are some links: +- [Direct Link - Git for Windows 2.26.0 - 64 Bit](https://github.com/git-for-windows/git/releases/download/v2.26.0.windows.1/Git-2.26.0-64-bit.exe) +- [Direct Link - Git for Windows 2.26.0 - 32 Bit](https://github.com/git-for-windows/git/releases/download/v2.26.0.windows.1/Git-2.26.0-32-bit.exe) -Python 3.7 or later is recommended due to performance improvements. You can get Python from here: https://www.python.org/ +Python 3.8 or later is recommended due to performance improvements. You can get Python from here: https://www.python.org/ ### Install Process 1. Run the installer .exe 2. Click Install +### Install From Source +To install from source, one must build and run the installer .exe using the instructions below at least once in order to setup the EdkRepo configuration files. One this is done, one may use the standard distutils method to install EdkRepo from source: + +`py -3 setup.py install` + ### Build Process #### Build Pre-Requisites - Visual Studio 2015 or later with the C# language installed -- 2.25.2