Helper library for all your Apple PassKit (Apple Wallet, Apple Passbook) needs: create passes, sign pass packages, receive [de]install notifications and send pass updates.
Attention: Apple Developer Account required!
- Create pass packages (
*.pkpassfiles):- With Fluent-styled
PassInfoBuilderandPassPackageBuilder - Using
byte[]and/orStreamas content images - Using
byte[]orStreamorX509Certificate2as certificates - Receive
MemoryStreamas result (save it to file or write to HttpResponse)
- With Fluent-styled
- Receive notifications from Apple about pass [de]installations and send updates:
- Add
UsePassKitMiddlewareinto yourStartup.Configure() - Implement
IPassKitServicefor real processing.
- Add
var options = new PassKitOptions()
{
PassCertificate = new X509Certificate2(File.ReadAllBytes("pass.pfx")),
AppleCertificate = new X509Certificate2(File.ReadAllBytes("AppleWWDRCA.cer")),
ConfigureNewPass =
p => p.Standard
.PassTypeIdentifier("your-pass-type-identifier")
.TeamIdentifier("your-team-identifier")
// Add more "defaults" here if needed
};
IPassKitHelper passKitHelper = new PassKitHelper(options);public void ConfigureServices(IServiceCollection services)
{
services.AddPassKitHelper(options =>
{
options.PassCertificate = new X509Certificate2(File.ReadAllBytes("pass.pfx"));
options.AppleCertificate = new X509Certificate2(File.ReadAllBytes("AppleWWDRCA.cer"));
options.ConfigureNewPass =
p => p.Standard
.PassTypeIdentifier("your-pass-type-identifier")
.TeamIdentifier("your-team-identifier")
// Add more "defaults" here if needed
});
}Check Apple's PassKit Package Format Reference for detailed description of all fields and valid values.
var pass = passKitHelper.CreateNewPass()
// Ths pass already have `PassTypeIdentifier`, `TeamIdentifier`
// and all other values you configured in options.
.Standard
.SerialNumber("PassKitHelper")
.OrganizationName("PassKit")
.Description("PassKitHelper demo pass")
.VisualAppearance
.Barcodes("1234567890128", BarcodeFormat.Code128)
.LogoText("PassKit Helper demo pass")
.ForegroundColor("rgb(44, 62, 80)")
.BackgroundColor("rgb(149, 165, 166)")
.LabelColor("rgb(236, 240, 241)")
.StoreCard
.PrimaryFields
.Add("version")
.Label("Library version")
.Value(libraryVersion)
.AuxiliaryFields
.Add("github")
.Label("GitHub link")
.Value("https://github.com/justdmitry/PassKitHelper");
var passPackage = passKitHelper.CreateNewPassPackage(pass)
.Icon(await File.ReadAllBytesAsync("images/icon.png"))
.Icon2X(await File.ReadAllBytesAsync("images/[email protected]"))
.Icon3X(await File.ReadAllBytesAsync("images/[email protected]"))
.Logo(await File.ReadAllBytesAsync("images/logo.jpg"))
.Strip(await File.ReadAllBytesAsync("images/strip.jpg"))
.Strip2X(await File.ReadAllBytesAsync("images/[email protected]"))
.Strip3X(await File.ReadAllBytesAsync("images/[email protected]"));
MemoryStream packageFile = await passPackage.SignAndBuildAsync();
// Now you have to "deliver" package file to user using any channel you have
// (save as attachment in email, download from your webapp etc)
await File.WriteAllBytesAsync("Sample.pkpass", packageFile.ToArray());Code above will create this beautiful pass:
Apple's server can call your endpoint/server to notify about user installed/deinstalled your pass, to fetch updated version of pass (when user 'pulls down' pass in Wallet). You will be able to send pushes when you want to update pass in user's wallet. Check Apple's PassKit Web Service Reference for technical details.
public class PassKitService : IPassKitService
{
public Task<int> RegisterDeviceAsync(…) {…}
public Task<int> UnregisterDeviceAsync(…) {…}
public Task<(int status, string[]? passes, string? tag)> GetAssociatedPassesAsync(…) {…}
public Task<(int statusCode, MemoryStream? passData)> GetPassAsync(…) {…}
public Task ProcessLogsAsync(…) {…}
}public void ConfigureServices(IServiceCollection services)
{
...
services.AddSingleton<IPassService, PassService>();
}
public void Configure(IApplicationBuilder app)
{
...
app.UsePassKitMiddleware("/callbacks/passkit");
...
}You need publicly-accessible url/hostname for your server, and it must be secured with https/ssl.
Add this information into your passes:
var pass = passKitHelper.CreateNewPass()
// your
// original
// pass content
// goes here
.WebService
.AuthenticationToken("some-random-secret-string")
.WebServiceURL("https://you.server.com/callbacks/passkit")AuthenticationToken is some "secret" string that you use to differentiate legal pass owners and malicious hackers.
WebServiceURL is hostname of your server and path that equal to one in UsePassKitMiddleware in previous step.
When users install your pass packge to their iOS and Mac devices - Apple server call your RegisterDeviceAsync. Save pushToken value in database, and when you need to update pass on user device - call IPassKitHelper.SendPushNotificationAsync(pushToken).
Use NuGet package PassKitHelper
For netcoreapp3.1:
- Microsoft.Extensions.Http, v3.1.1
- Newtonsoft.Json, v12.0.2
- System.Security.Cryptography.Pkcs, v4.6.0
For netstandard2.0:
- Microsoft.AspNetCore.Http.Abstractions, v2.1.1
- Microsoft.Extensions.DependencyInjection.Abstractions, v2.1.1
- Microsoft.Extensions.Logging.Abstractions, v2.1.1
- Microsoft.Extensions.Http, v2.1.1
- Newtonsoft.Json, v12.0.2
- System.Security.Cryptography.Pkcs, v4.6.0
You need netcore3.1 to run build and tests;
Tests can be run with dotnet test.
- Thanks for inspiration to Tomas McGuinness and his dotnet-passbook package.
- Thanks to maxpixel.net for sample kitten images.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent