From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mga06.intel.com (mga06.intel.com [134.134.136.31]) by mx.groups.io with SMTP id smtpd.web12.822.1586377813720053191 for ; Wed, 08 Apr 2020 13:30:13 -0700 Authentication-Results: mx.groups.io; dkim=pass header.i=@intel.onmicrosoft.com header.s=selector2-intel-onmicrosoft-com header.b=KJyJ/uiy; spf=pass (domain: intel.com, ip: 134.134.136.31, mailfrom: ashley.e.desimone@intel.com) IronPort-SDR: uM0T2qRZoGyHd1YN+nzUTVREz5SIOS+jt8/efIpIVQLRql063/uL+tOsIHt7Pkbp1nliouRd16 AYWzyepcTj4A== X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from orsmga006.jf.intel.com ([10.7.209.51]) by orsmga104.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 08 Apr 2020 13:30:12 -0700 IronPort-SDR: yYGwHeNEnYgGH7snyrgipKMPEGSAOpDuM2oMiiXtnJK5WDIoO9eYUw6zDvcCNMxcjBHPz0R69K CBKzWiPVsCiA== X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.72,359,1580803200"; d="scan'208";a="254908079" Received: from orsmsx105.amr.corp.intel.com ([10.22.225.132]) by orsmga006.jf.intel.com with ESMTP; 08 Apr 2020 13:30:12 -0700 Received: from ORSEDG002.ED.cps.intel.com (10.7.248.5) by ORSMSX105.amr.corp.intel.com (10.22.225.132) with Microsoft SMTP Server (TLS) id 14.3.439.0; Wed, 8 Apr 2020 13:30:12 -0700 Received: from NAM12-MW2-obe.outbound.protection.outlook.com (104.47.66.40) by edgegateway.intel.com (134.134.137.101) with Microsoft SMTP Server (TLS) id 14.3.439.0; Wed, 8 Apr 2020 13:30:12 -0700 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=HfwF+BC+6rkw/VkHk2IsGQqFfU3aq16ylEHaItb/SatxCh7K8rWIYYho9aZUdWVViQxS/ovcB1XbnHm8aZJBUSG8oyy1QBdIGAt/4CYP3MJjc/5aESml7IeKmiW2hCSaEiLh6WCuSDZD8I5tPFQKTK0iu0AIcaxYgG1ZNfSRyHpSTblYfdHuy846VXLOnJTFU8VX8AeEC+fV6EpOV1UtGlvVijBte/uGmDhCmKroHSckAs3y32ts9JIsWe7fIZhKmtxDRMsuSShdjQpxtSgEn9aSTqTK+iZ0Kajl1seyGFjY9wrkeI58ZMAaC7jS7cNGaYRES1lYKH44RSDX0zXv9w== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=SmOa/nkVSMkIXod9Q1SxFQJgQyFd7TWvKQGACJX9RMw=; b=L3AaQifiQj3MEgZ3Qs9nCBVtoixOm78ZHiWYAUG0NbbyUtuqKAyoDmYE0ch0ZpSwqy4jPLHiYEWMtIS2u2t3Q187ROk2mvkHVGgsRqQECD383dVwh/fQq5hdUAQu6EDz7iYPHy0oQVAFkAdT2vvAl2XVfz+wvpHCn1oLvugRWPQHQLpt92ibmxbAUctADny8MAj26RURiXggO41dKoQfM+SWGqLYWimkafxr0iqHan+0BIsImVNPNzvJbPrEnMHJNDPgCW1loGTUgdYiyfpe/wy3ZnEoD+69yiYcitsFBWIfJD8EfriTy8cVIfYQKmVybwrMi8ur/I3DJJuZx7NHuQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=intel.com; dmarc=pass action=none header.from=intel.com; dkim=pass header.d=intel.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=intel.onmicrosoft.com; s=selector2-intel-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=SmOa/nkVSMkIXod9Q1SxFQJgQyFd7TWvKQGACJX9RMw=; b=KJyJ/uiy4dI3flw7ZXqIaevryMWUfljI0pQjOB41e35jLPJeY95vamsWvMIdoJJBmc9ULP6Fhxkw1iG7UrlBBjCp9ikFFmeewa92peI/5AQoD3HVmtZ7bPKBBq1JBX2kvptQEWwCYK+Oq6sCk4c4CtU7fIVMX2YJWD0U+g2t68M= Received: from DM6PR11MB3628.namprd11.prod.outlook.com (2603:10b6:5:144::25) by DM6PR11MB3596.namprd11.prod.outlook.com (2603:10b6:5:13a::14) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.2878.16; Wed, 8 Apr 2020 20:30:10 +0000 Received: from DM6PR11MB3628.namprd11.prod.outlook.com ([fe80::5904:e7d9:f64d:9a7e]) by DM6PR11MB3628.namprd11.prod.outlook.com ([fe80::5904:e7d9:f64d:9a7e%3]) with mapi id 15.20.2878.021; Wed, 8 Apr 2020 20:30:10 +0000 From: "Ashley E Desimone" To: "devel@edk2.groups.io" , "Desimone, Nathaniel L" CC: "Pandya, Puja" , "Bjorge, Erik C" , "Agyeman, Prince" , Bret Barkelew , Philippe Mathieu-Daude Subject: Re: [edk2-devel] [edk2-staging/EdkRepo] [PATCH 2/2] EdkRepo: Update README.md Thread-Topic: [edk2-devel] [edk2-staging/EdkRepo] [PATCH 2/2] EdkRepo: Update README.md Thread-Index: AQHWDHUlhMi7dxDpR0marzlcc5Fkm6hvsAvg Date: Wed, 8 Apr 2020 20:30:09 +0000 Message-ID: References: <20200407003950.33249-1-nathaniel.l.desimone@intel.com> <20200407003950.33249-3-nathaniel.l.desimone@intel.com> In-Reply-To: <20200407003950.33249-3-nathaniel.l.desimone@intel.com> Accept-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: dlp-version: 11.2.0.6 dlp-reaction: no-action dlp-product: dlpe-windows authentication-results: spf=none (sender IP is ) smtp.mailfrom=ashley.e.desimone@intel.com; x-originating-ip: [134.134.136.213] x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: 3fb58d4a-7be4-467f-818d-08d7dbfba22e x-ms-traffictypediagnostic: DM6PR11MB3596: x-ld-processed: 46c98d88-e344-4ed4-8496-4ed7712e255d,ExtAddr x-ms-exchange-transport-forked: True x-microsoft-antispam-prvs: x-ms-oob-tlc-oobclassifiers: OLM:8273; x-forefront-prvs: 0367A50BB1 x-forefront-antispam-report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:DM6PR11MB3628.namprd11.prod.outlook.com;PTR:;CAT:NONE;SFTY:;SFS:(10019020)(376002)(136003)(366004)(346002)(39850400004)(396003)(26005)(7696005)(54906003)(71200400001)(15650500001)(6636002)(76116006)(53546011)(8676002)(4326008)(110136005)(81156014)(33656002)(52536014)(86362001)(316002)(5660300002)(2906002)(66946007)(81166007)(6506007)(55016002)(66476007)(9686003)(478600001)(966005)(8936002)(186003)(66556008)(64756008)(66446008)(46800400005)(460985005);DIR:OUT;SFP:1102; x-ms-exchange-senderadcheck: 1 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: X25RxG/aNr//qiNuC2ph/nVGqYYJY2Bq2ElNKAMDZOM4f/Ri6Fwv3ils27Y0F4W6oM+8wdFTcCkn2OaBrSsivBwPvFBX3smi4r5r7Wc37sEiRh6e6pwV99n3i0Yv/3V+S09Sh45AXi8/ddblC99BSv68jqY/B3xLA2WiVlQPtJvyuN/T1LNWfWyfgjxytjgTw0QzoTbms+2FBJewaHG5lktTQ8NSnAw8T/RTasvx8CxUE4igLYu7hzrs8GCe3v9lMemI9NdW//FMBQzZXrwSOVLSf3Gfug4Q4bOBFg1FgNGTVseVPgzB4kVKljoD8n7HMKNg64yeL7Uhdvl3rM7QtnRs7H6OqUggiJ5Ye+BgVgDawz2MQtbupc6WIKJtmafLG71Fa9d/KVW43JkaC0akjimsviiFPL5zuiZIUbc7TM36WnNSjbV21tNsAjDmfZD4KiHpw3hVct0nxcsaYO4IRv89OsCHL1ewBuUpUT2+QWH5KdDiA2tjnjNfB3ZfllCmOfKx/u/zAU6JYbwLKruV8AP5vhgAj3kg1zDtpSxBNq21HOkdiGVYfxdonlLPj09dVCZ8rNQ11Q3qAFbsSFHCA2in+Lz4aY5BL/ZHDFjtAYs= x-ms-exchange-antispam-messagedata: LzXoHZvDTOgGSOPCpApI1GcdxMsLg//GrrvB4sIqkT2oAP31d938h6cgPGUgTVubWt9BC35DU3V2NiOVGJAC1zJp7gQBqycfAUmnvPdCH63eko7NP8f81LtRUpA7XHct9tPro7OEca+/SUOvlUlypA== MIME-Version: 1.0 X-MS-Exchange-CrossTenant-Network-Message-Id: 3fb58d4a-7be4-467f-818d-08d7dbfba22e X-MS-Exchange-CrossTenant-originalarrivaltime: 08 Apr 2020 20:30:09.9336 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 46c98d88-e344-4ed4-8496-4ed7712e255d X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: EEZny16wEIrSDvalvdLV4VDDiaxZdZv1UlbTqpF3Sy4nQ0y/AXJNtFS+vIJ+wusMnNFXH9ria0W5F6HA5lhvgdfW4bP9EKtL5/auWoxAlk0= X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM6PR11MB3596 Return-Path: ashley.e.desimone@intel.com X-OriginatorOrg: intel.com Content-Language: en-US Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable Reviewed-by: Ashley DeSimone -----Original Message----- From: devel@edk2.groups.io On Behalf Of Nate DeSimo= ne Sent: Monday, April 6, 2020 5:40 PM To: devel@edk2.groups.io Cc: Pandya, Puja ; Bjorge, Erik C ; Agyeman, Prince ; Bret Barkelew ; Philippe Mathieu-Daude Subject: [edk2-devel] [edk2-staging/EdkRepo] [PATCH 2/2] EdkRepo: Update R= EADME.md - 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 wh= eel 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 m= ethod of installing command line software on macOS that was not originally = provided by Apple. EdkRepo has several dependencies that are distributed vi= a Homebrew. + +Type the following command to install Homebrew: + +`/bin/bash -c "$(curl -fsSL=20 +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 co= mpletions, run the following command: + +`/bin/bash -c "$(curl -fsSL=20 +https://raw.githubusercontent.com/tianocore/edk2-staging/EdkRepo/edkrep +o_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 distributio= n tarball using the following commands first: + +1. `pip install wheel` (If not done already) 1. `cd build-scripts` 2.=20 +`./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 a= ny 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 a= ny 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=20 +Bit](https://github.com/git-for-windows/git/releases/download/v2.26.0.w +indows.1/Git-2.26.0-64-bit.exe) +- [Direct Link - Git for Windows 2.26.0 - 32=20 +Bit](https://github.com/git-for-windows/git/releases/download/v2.26.0.w +indows.1/Git-2.26.0-32-bit.exe) -Python 3.7 or later is recommended due to performance improvements. You c= an get Python from here: https://www.python.org/ +Python 3.8 or later is recommended due to performance improvements. You= =20 +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 t= he instructions below at least once in order to setup the EdkRepo configura= tion 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