Skip to content

Getting Started

Jump to bottom
James Clancey edited this page Feb 4, 2020 · 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. 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 Comet Debug extension

Install the Comet Debug from the Marketplace.

Time to Ride!

  1. Start a New Project
dotnet new comet -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

NOTE: you may need to run this targeting both projects, the library and the iOS, by running it within the iOS folder as well. Alternatively use msbuild /t: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