historical/xcloud-keyboard-mouse-inftrial.git/safari/README.md
2024-01-16 11:20:27 -06:00

2.1 KiB

How to Build/Run on Safari

These instructions are for local development of the Safari extension.

Setup

  1. Install Xcode
  2. Install Node.js
  3. Clone this repo locally to your computer
  4. Open the folder where you cloned the repo in Terminal (e.g. cd ~/GitHub/xcloud-keyboard-mouse)
  5. Install dependencies with npm install
  6. Build the extension with npm run build:safari (or npm run watch:safari if you want to reload as you make changes to the code)
  7. Open Safari and enable the "Allow Unsigned Extensions" option from the Develop menu. You will first have to enable the Develop menu in Safari by checking the option in Safari > Preferences > Advanced. See Apple's instructions here.
    Safari develop menu
  8. Open the Xcode project with open safari/Keyboard\ \&\ Mouse\ for\ Xbox\ xCloud/Keyboard\ \&\ Mouse\ for\ Xbox\ xCloud.xcodeproj/, or double click the .xcodeproj file via Finder, or via File > Open in Xcode
  9. Select the macOS app in the Scheme menu and click the Run button (looks like a play button) in the Xcode menu to run the app. See Apple's instructions here.
    Xcode scheme menu
  10. Once the app has been run one time you can quit it - the extension should be installed! You can then enable it in Safari > Preferences > Extensions.
    Enable extension
  11. Go to https://xbox.com/play and enable the extension to run on that page by clicking the new extension icon in the Safari toolbar, sellecting "Always Allow on This Website", and refreshing the page.
    Always Allow