Skip to content
This repository has been archived by the owner on Jan 14, 2022. It is now read-only.

nor0x/AppCenter-XMac

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

UPDATE 14.01.2022

this repository is now archived and read-only, because microsoft/appcenter-sdk-dotnet#1576 is merged and the AppCenter SDK version 4.5.0 has Xamarin.Mac support built-in. Please update your dependencies and use the official NuGet packages going forward.

If you want to read about how this repo get started check out my blog post: https://johnnys.news/2022/01/AppCenter-XMac-is-dead-long-live-Microsoft-AppCenter

UPDATE 27.09.2021

the AppCenter team approached me to discuss the strategy of official support for Xamarin.Mac. There are resources available now to bring the dotnet-sdk to Xamarin.Mac and the implementation is based on this repository. Feel free to follow the progress here in the PR microsoft/appcenter-sdk-dotnet#1576. Once we have Xamarin.Mac support in the official repository i will archive AppCenter-XMac its packages which won't receive new updates from this point on.


AppCenter-XMac

Build Status

AppCenter-XMac are Xamarin.Mac bindings for the AppCenter SDK.

Module Version Bindings Sample NuGet
AppCenter 4.4.0
AppCenter.Analytics 4.4.0
AppCenter.Crashes 4.4.0

How to use:

public override void DidFinishLaunching(NSNotification notification)
{
    AppCenter.Start("macos={your-secret-goes-here};",typeof(Analytics), typeof(Crashes));
    base.DidFinishLaunching(notification);
}

Check out the Demo App for a Xamarin.Forms based sample.

ProTips

  • to inspect handled errors you just have to add &errorType=all to the URL at appcenter -> diagnostics -> issues (kudos)

  • for signed builds you have to pass --deep as an additional argument to codesign

  • currently <LinkMode>None</LinkMode> is required in the macOS.csproj file. Enabling other Linker modes is planned for a future release

official README from https://github.com/microsoft/appcenter-sdk-dotnet/blob/develop/README.md

⬇️ README.md ⬇️

GitHub Release NuGet license

Visual Studio App Center SDK for .NET

App Center is your continuous integration, delivery and learning solution for iOS, Android, and Windows apps. Get faster release cycles, higher-quality apps, and the insights to build what users want.

The App Center SDK uses a modular architecture so you can use any or all of the following services:

  1. App Center Analytics: App Center Analytics helps you understand user behavior and customer engagement to improve your app. The SDK automatically captures session count, device properties like model, OS version, etc. You can define your own custom events to measure things that matter to you. All the information captured is available in the App Center portal for you to analyze the data.

  2. App Center Crashes: App Center Crashes will automatically generate a crash log every time your app crashes. The log is first written to the device's storage and when the user starts the app again, the crash report will be sent to App Center. Collecting crashes works for both beta and live apps, i.e. those submitted to the App Store. Crash logs contain valuable information for you to help fix the crash.

  3. App Center Distribute: App Center Distribute will let your users install a new version of the app when you distribute it via the App Center. With a new version of the app available, the SDK will present an update dialog to the users to either download or postpone the new version. Once they choose to update, the SDK will start to update your application.

    Google Play considers the in-app update code as malicious behavior even if it isn’t used at runtime. Please use App Center Distribute Play instead before submitting your app to Google Play. Failure to not remove the in-app update code can lead to noncompliance and removal of the app from Google Play. See Remove in-app updates for Google Play builds documentation for details.

  4. App Center Distribute Play: App Center Distribute Play is stubbing the Distribute package's APIs to avoid Google Play rejecting the application for malicious behavior. It must be used only for build variants which are going to be published on Google Play.

  5. App Center Push: App Center Push enables you to send push notifications to users of your app from the App Center portal. We use APNS for iOS apps, FCM for Android and WNS for UWP apps. You can also segment your user base based on a set of properties and send them targeted notifications.

1. Get started

It is super easy to use App Center. Have a look at our get started documentation and onboard your app within minutes. Our detailed documentation is available as well.

2. Contributing

We are looking forward to your contributions via pull requests.

2.1 Code of Conduct

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

2.2 Contributor License

You must sign a Contributor License Agreement before submitting your pull request. To complete the Contributor License Agreement (CLA), you will need to submit a request via the form and then electronically sign the CLA when you receive the email containing the link to the document. You need to sign the CLA only once to cover submission to any Microsoft OSS project.

3. Contact

3.1 Support

App Center SDK support is provided directly within the App Center portal. Any time you need help, just log in to App Center, then click the blue chat button in the lower-right corner of any page and our dedicated support team will respond to your questions and feedback. For additional information, see the App Center Help Center.

3.2 Twitter

We're on Twitter as @vsappcenter.