如何在 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]