Skip to content

Getting Started

Jump to bottom
David Ortinau edited this page Aug 27, 2019 · 18 revisions

Comet is a few things:

  • a platform agnostic UI toolkit
  • a programming pattern

Currently the best experience is on macOS with VS Code and building for iOS.

Pre-Requisites

  1. Visual Studio Code
  2. .NET Core 3.0
  3. Platform install
    1. IOS - install the latest version of Xcode and Xamarin.iOS
    2. Android - install the latest version of Xamarin.Android

To Make Your Ride More Enjoyable

  1. Install the Comet Project Templates

Open a terminal and run:

dotnet new -i Clancey.Comet.Templates.Multiplatform
  1. Install the VS Code Extension

Browse the VS Code marketplace for Comet Debug and install it.

Time to Ride!

  1. Start a New Project
dotnet new comet-app -n RideTheComet
  1. Open the Project in VS Code
code RideTheComet
  1. Restore the NuGets for your library project and the iOS project.

VS Code will often prompt you to restore, however you can restore a few other ways.

With VS Code commands:

Type SHFT+CMD+P and type restore to choose the restore command.

With dotnet cli:

dotnet restore
  1. Ride the Comet!

Start debugging. With the Comet Debug extension installed you can type CMD + Return.

VS Code should have already selected the iOS project as your startup project, and prompt you to select a simulator from your Xcode installation.

Once running, you can make changes to your view code and your app running in the simulator will update in real-time. Any invalid code will either report an error to you in the output window, or may crash the app and require reboot to get going again. So write good code!

Clone this wiki locally