.NET MAUI引入GitHub托管Zettle Android SDK问题咨询

云原生阿岚

2026-8-10

.NET MAUI Android集成Zettle SDK解决方案

1. 配置GitHub Packages仓库

Zettle SDK托管在GitHub Packages，需在MAUI Android项目的Platforms/Android/build.gradle文件中添加仓库配置：

找到文件内的repositories代码块，插入GitHub Packages的maven仓库配置，替换为你的GitHub用户名和有权限的Personal Access Token（Token需开启read:packages权限，在GitHub个人设置中生成）：

repositories {
    maven {
        url = uri("https://maven.pkg.github.com/zettle/zettle-android-sdk")
        credentials {
            username = "你的GitHub用户名"
            password = "你的GitHub Personal Access Token"
        }
    }
    // 保留原有google()、mavenCentral()等仓库配置
}

2. 添加SDK依赖

同样在build.gradle的dependencies块中加入Zettle SDK的依赖，替换为官方指定的版本号：

dependencies {
    // 保留项目原有依赖
    implementation 'com.paypal.zettle:zettle-sdk:X.Y.Z' // 替换为实际版本号
}

3. 配置Android权限

在Platforms/Android/AndroidManifest.xml中添加Zettle要求的基础权限，比如网络权限：

<uses-permission android:name="android.permission.INTERNET" />
<!-- 按需添加官方要求的其他权限 -->

4. 初始化SDK

在MAUI Android项目的MainApplication.cs中，重写OnCreate方法完成SDK初始化：

using Android.App;
using Android.Runtime;
using Com.Paypal.Zettle.Sdk;

namespace YourAppNamespace.Platforms.Android;

[Application]
public class MainApplication : MauiApplication
{
    public MainApplication(IntPtr handle, JniHandleOwnership ownership)
        : base(handle, ownership)
    {
    }

    protected override MauiApp CreateMauiApp() => MauiProgram.CreateMauiApp();

    public override void OnCreate()
    {
        base.OnCreate();
        // 用你的Zettle客户端ID初始化SDK
        ZettleSdk.Initialize(this, "你的Zettle客户端ID");
    }
}