飞奔的炮台 发表于 2022-4-20 16:34:37

如何在 Xamarin 中快速集成 Android 版远程配置

Xamarin作为微软提供的移动服务多系统开发平台,成为很多开发者首选的应用开发平台。AppGallery Connect(以下简称AGC)也在逐步的支持Xamarin的SDK。今天就手把手教大家如何快速接入Xamarin版远程配置服务。
接入步骤
安装Xamarin环境
Xamarin的御用开发平台是Visual Studio,所以我们需要首先安装Visual Studio 2019.
下载地址:https://visualstudio.microsoft.com/zh-hans/downloads/
下载好后进行安装,我们还需要安装Xamarin配套的插件,Mobile development with .NET,中文叫“使用.NET的移动开发”,安装完成后就可以通过Visual Studio进行Xamarin的Android和iOS开发了。

在AGC页面开通远程配置并创建相应的配置项
具体配置步骤可以参考远程配置官方文档:
https://developer.huawei.com/consumer/cn/doc/development/AppGallery-connect-Guides/agc-remoteconfig-android-cloudconfig-0000001056587179
创建Xamarin工程
1、在Visual Studio中创建新项目
选择移动应用(Xamarin.Forms),将应用的名称等信息设置好后,创建项目

2、将远程配置的Xamarin包集成到新的项目中
有两种方式集成Xamarin包
第一种是云端方式集成,在目录栏右击选择管理NuGet程序包

在浏览选项中搜索Huawei.Agconnect.RemoteConfiguration,点击安装即可

第二种方式是本地集成NuGet包,首先需要将所有需要的NuGet包放入本地的一个文件夹中

我们按照第一种的方式打开NuGet包管理器,点击程序包源边上的设置图标,打开选项目录

点击绿色的加号添加新的包源,在源的地方输入刚刚存放NuGet本地包的文件夹目录即可。

3、添加 AGC 配置文件
AGC为开发者准备了一个存放所有应用相关信息的配置json文件,我们需要将这个文件集成到项目中以便后续调用接口时使用,我们的SDK会自动读取里面的内容,无需开发者调用时手动传入了,具体步骤如下
3.1 从AGC管理台中下载agconnect-services.json文件,将文件放入项目的Assets目录下

3.2 在项目中创建一个新的类,HmsLazyInputStreams.cs,将如下代码写入进行json文件的内容读取
using System;
using System.IO;
using Android.Util;
using Android.Content;
using Huawei.Agconnect.Config;
namespace XamarinHmsRemoteConfig
{
    class HmsLazyInputStream : LazyInputStream
    {
      public HmsLazyInputStream(Context context) : base(context)
      {
            Get(context);
      }
      public override Stream Get(Context context)
      {
            try
            {
                return context.Assets.Open("agconnect-services.json");
            }
            catch (Exception e)
            {
                Log.Error(e.ToString(), "Can't open agconnect file");
                return null;
            }
      }
    }
}3.3 再创建一个Content provider类,写入如下代码已让读取文件可以在启动应用时进行,要注意,content provider中的包名需要与应用包名一致(包括项目中设置的包名以及在AGC管理台中设置的包名)。
using System;
using Android.Content;
using Android.Database;
using Huawei.Agconnect.Config;
namespace XamarinHmsRemoteConfig
{
    { "com.huawei.cordova.remoteconfig.XamarinCustomProvider" }, InitOrder = 99)]
    public class XamarinCustomProvider : ContentProvider
    {
      public override int Delete(Android.Net.Uri uri, string selection, string[] selectionArgs)
      {
            throw new NotImplementedException();
      }
      public override string GetType(Android.Net.Uri uri)
      {
            throw new NotImplementedException();
      }
      public override Android.Net.Uri Insert(Android.Net.Uri uri, ContentValues values)
      {
            throw new NotImplementedException();
      }
      public override bool OnCreate()
      {
            AGConnectServicesConfig config = AGConnectServicesConfig.FromContext(Context);
            config.OverlayWith(new HmsLazyInputStream(Context));
            return false;
      }
      public override ICursor Query(Android.Net.Uri uri, string[] projection, string selection, string[] selectionArgs, string sortOrder)
      {
            throw new NotImplementedException();
      }
      public override int Update(Android.Net.Uri uri, ContentValues values, string selection, string[] selectionArgs)
      {
            throw new NotImplementedException();
      }
    }
}3.4 设置包名
右击项目找到属性选项,在Android清单页签找到程序包名称,设置应用的包名。

4、添加本地默认配置
远程配置支持开发者在本地配置一个默认值。这种配置有两种方式,
第一种是通过xml文件设置相关配置,我们可以在Resource文件夹下的Xml文件夹创建一个xml文件,存放配置项和默认值

在代码中调用ApplyDefault方法读取相应的xml文件即可
AGConnectConfig.Instance.ApplyDefault(Resource.Xml.RemoteConfig);
第二种方式实在代码中动态的设置默认配置,示例如下:
IDictionary<string, Java.Lang.Object> ConfigVariables = new Dictionary<string, Java.Lang.Object>();
ConfigVariables.Add("value1", "Default");
AGConnectConfig.Instance.ApplyDefault(ConfigVariables);5、Fetch
Fetch功能是远程配置最核心的功能,fetch接口可以从云端将最新的配置值下载到本地来进行实时配置。接口有一个参数,代表着接口从云端获取值的间隔,如果不传值,那么我们就会默认为12小时。
AGConnectConfig.Instance.Fetch(fetchInterval).AddOnSuccessListener(new TaskListener(this)).AddOnFailureListener(new TaskListener(this));
6、MergedAll
其余的接口都与Android版本一致,但是有一个接口与Android版本名称上有些许不同,就是MergedAll方法。这个方法在Android上名称为getMergedAll,作用是返回默认值和云端值合并后的所有值。
AGConnectConfig.Instance.MergedAll;
以上就是快速接入Xamarin版远程配置的全部流程,随着越来越多的服务支持Xamarin,我也会给大家带来更多的接入教程。


   
   
   
                        

https://www.cnblogs.com/developer-huawei/p/16164754.html
页: [1]
查看完整版本: 如何在 Xamarin 中快速集成 Android 版远程配置