Skip to main content

Setup/Configurations for Mac

Connecting:

Connecting

*You will need to be at our office or on the VPN to do this.this

  1. Download VNC Viewer
  2. Make sure the Mac you're wanting to connect to is actually plugged in (check the ethernet cable) and turned on
    • The two QA ones are by all the other QA testing machines (as of 10/25/2022)
    • The Dev one is by McKay's space - in the Ops corner (as of 10/25/2022)
  3. Once it's open, add a new connection see credentials
    • The dev mac currently is the only machine that has all the signing certificates for the Mac Desktop Client
      • The dev mac is often turned off
    • The QA mac 1 is much faster than any of the others, but doesn't have the signing certificates for the Desktop Client
      • When setting up the QA mac within VNC, turn Encryption > Prefer Off
      • Make sure no one from QA is using it

Credentials

DEV MAC

IP Address: 10.10.0.60
Username: dev
Password: BrianRocks!

QA MAC 1

IP Address: 10.10.0.68
Username: qa
Password: qaRocks!

QA MAC 2 (not recommended)

IP Address: 10.10.0.67
Username: qa
Password: QARocks!

Work:

Before you get started

you

 You will need the following installed on your machine (Dev mac and QA mac 1 have these already):

  • XCode
  • Visual Studio for mac with:
    • .NET
    • .NET WebAssembly Build Tools
    • macOS (Cocoa) - all versions listed
    • Android
    • iOS
  • Our codebase

Version Control

IMPORTANT - the master branch for the Mac Desktop Client is different from windows.  You're looking for origin/mac-master. Branch off of that unless instructed otherwise

Sometimes git through Visual Studio for mac is really dumb, especially with changing branches.  The good news is that you can use git through terminal where needed.

Useful Git Commands

Force change branches

        • git switch -f <branch-name>

It tries rebasing on branch swap sometimes

        • git rebase --quit

Nuget

You will probably need to add our UtopiaNuget at some point to a project on mac.  The process is slightly different than what is described in our wiki page.

Mac Desktop Client

IMPORTANT - the master branch for mac is different from windows.  You're looking for origin/mac-master. Branch off of that unless instructed otherwise

 

Building