如何构建Android Sync Provider :Part1

简介:

 

Android2.0 SDK带来的一个好东西就是你可以写一个普通的同步供应商程序,并将其与系统的联系薄,日历等集成。唯一的问题是相关的文档十分的少。还有一个糟糕的问题在于,如果你在某一个地方出了错,Android系统就会崩溃重启。面临如此挑战,我依靠这稀少的文档,以及很少的帖子,还有Android地带的一些代码去建立了一个同步程序----Last.fm 。你想要知道怎么去建立你自己的同步程序么?读下去吧

账户验证

第一个令人疑惑的问题就是账户验证问题,你可以从这个地方了解到更多的信息。http://developer.android.com/reference/android/accounts/AbstractAccountAuthenticator.html

这里定义了该账户如何在“账号&同步”设置中出现的。一个账号的的验证需要3部分来实现:1. 一个从onBind方法返回AbstractAccountAuthenticator 子类的一个服务2. 一个Activityt提供用户输入他们的凭据(账号秘密信息),一个xml文件去描述账号信息展示给用户时( an xml file describing how your account should look when displayed to the user.)同时,你也需要在android.mainfest.xml中添加android.permission.AUTHENTICATE_ACCOUNTS权限

服务

验证服务程序期望从一个onBind方法中返回一个AbstractAccountAuthenticator 的子类。如果你坚持不这么做的话,带来的后果就是当你向系统添加一个账号时,android会将会崩溃并且重启。所幸实现AbstractAccountAuthenticator 并不是一件困难的事情,我们只需要实现其中的addAccount方法即可。该方法返回一个Intent,系统将会用他来为用户展示一个登陆框。该如下的实现将会运行我们的service“fm.last.android.sync.LOGIN”.用户等登录完毕后,,会有一个AccountAuthenticatorResponse 对象传出,我们可以用来将其回传给系统。

AccountAuthenticatorService.java

1   import   fm . last . android . LastFm; 
2   import   android . accounts . AbstractAccountAuthenticator; 
3   import   android . accounts . Account; 
4   import   android . accounts . AccountAuthenticatorResponse; 
5   import   android . accounts . AccountManager; 
6   import   android . accounts . NetworkErrorException; 
7   import   android . app . Service; 
8   import   android . content . Context; 
9   import   android . content . Intent; 
10  import   android . os . Bundle; 
11  import   android . os . IBinder; 
12  import   android . util . Log; 
13    
14  /* * 
15    *   Authenticator   service   that   returns   a   subclass   of   AbstractAccountAuthenticator   in   onBind() 
16    */ 
17  public   class   AccountAuthenticatorService   extends   Service   { 
18    private   static   final   String   TAG   =   " AccountAuthenticatorService " ; 
19    private   static   AccountAuthenticatorImpl   sAccountAuthenticator   =   null ; 
20    
21    public   AccountAuthenticatorService()   { 
22      super (); 
23    } 
24    
25    public   IBinder   onBind(Intent   intent)   { 
26      IBinder   ret   =   null ; 
27      if   (intent . getAction() . equals(android . accounts . AccountManager . ACTION_AUTHENTICATOR_INTENT)) 
28        ret   =   getAuthenticator() . getIBinder(); 
29      return   ret; 
30    } 
31    
32    private   AccountAuthenticatorImpl   getAuthenticator()   { 
33      if   (sAccountAuthenticator   = =   null ) 
34        sAccountAuthenticator   =   new   AccountAuthenticatorImpl( this ); 
35      return   sAccountAuthenticator; 
36    } 
37    
38    private   static   class   AccountAuthenticatorImpl   extends   AbstractAccountAuthenticator   { 
39      private   Context   mContext; 
40    
41      public   AccountAuthenticatorImpl(Context   context)   { 
42        super (context); 
43        mContext   =   context; 
44      } 
45    
46      /* 
47        *     The   user   has   requested   to   add   a   new   account   to   the   system.     We   return   an   intent   that   will   launch   our   login   screen   if   the   user   has   not   logged   in   yet, 
48        *     otherwise   our   activity   will   just   pass   the   user's   credentials   on   to   the   account   manager. 
49        */ 
50      @Override 
51      public   Bundle   addAccount(AccountAuthenticatorResponse   response,   String   accountType,   String   authTokenType,   String[]   requiredFeatures,   Bundle   options) 
52          throws   NetworkErrorException   { 
53        Bundle   reply   =   new   Bundle(); 
54        
55        Intent   i   =   new   Intent(mContext,   LastFm . class ); 
56        i . setAction( " fm.last.android.sync.LOGIN " ); 
57        i . putExtra(AccountManager . KEY_ACCOUNT_AUTHENTICATOR_RESPONSE,   response); 
58        reply . putParcelable(AccountManager . KEY_INTENT,   i); 
59        
60        return   reply; 
61      } 
62    
63      @Override 
64      public   Bundle   confirmCredentials(AccountAuthenticatorResponse   response,   Account   account,   Bundle   options)   {
65        return   null ; 
66      } 
67    
68      @Override 
69      public   Bundle   editProperties(AccountAuthenticatorResponse   response,   String   accountType)   { 
70        return   null ; 
71      } 
72    
73      @Override 
74      public   Bundle   getAuthToken(AccountAuthenticatorResponse   response,   Account   account,   String   authTokenType,   Bundle   options)   throws   NetworkErrorException   { 
75        return   null ; 
76      } 
77    
78      @Override 
79      public   String   getAuthTokenLabel(String   authTokenType)   { 
80        return   null ; 
81      } 
82    
83      @Override 
84      public   Bundle   hasFeatures(AccountAuthenticatorResponse   response,   Account   account,   String[]   features)   throws   NetworkErrorException   { 
85        return   null ; 
86      }   
87      @Override 
88      public   Bundle   updateCredentials(AccountAuthenticatorResponse   response,   Account   account,   String   authTokenType,   Bundle   options)   { 
89        return   null ; 
90      } 
91    } 
92  } 
93

该验证服务需要在Android.Mainfest.xml中使用元数据标签定义一下。如下

Snippet from AndroidManifest.xml

< service  android:name = " AccountAuthenticatorService " 
android:exported = " true "  android:process = " :auth " > 
  < intent-filter > 
    < action  android:name = " android.accounts.AccountAuthenticator "   / > 
  < /intent-filter > 
  < meta-data  android:name = " android.accounts.AccountAuthenticator " 
   android:resource = " @xml/authenticator "   / > 
< /service > 
9

Xml文件

账号的xml文件中定义了当应用程序与你的账号互动的时候,应用程序将会看到的东西(是不是向国内其他应用程序使用QQ一些应用一样,首先会有一个授权,询问用户当前的应用程序可以访问你的用户的哪些信息?------我的理解)其中包含了用户可读的名字,你所定义的系统账号类型,图标,对一个包含当用户修改账号时可以看到的PreferenceScreens 的xml文件。

authenticator.xml

< account-authenticator  xmlns:android = " http://schemas.android.com/apk/res/android " 
       android:accountType = " fm.last.android.account " 
       android:icon = " @drawable/icon " 
       android:smallIcon = " @drawable/icon " 
       android:label = " @string/app_name " 
       android:accountPreferences = " @xml/account_preferences " / > 
7

account_preferences.xml

1   < PreferenceScreen 
2      xmlns:android = " http://schemas.android.com/apk/res/android " > 
3           < PreferenceCategory 
4                          android:title = " General   Settings "   / > 
5     
6           < PreferenceScreen 
7                  android:key = " account_settings " 
8                  android:title = " Account   Settings " 
9                  android:summary = " Sync   frequency,   notifications,   etc. " > 
10                  < intent 
11                         android:action = " fm.last.android.activity.Preferences.ACCOUNT_SETUP " 
12                         android:targetPackage = " fm.last.android " 
13                         android:targetClass = " fm.last.android.activity.Preferences "   / > 
14          < /PreferenceScreen > 
15  < /PreferenceScreen > 
16

集成(putting it all together)

现在我们可以准备开始测试了。Android 账号的设置部分并不能完好的捕捉异常。如果有地方出错了,设备会重启。最好的测试方式是运行模拟器后,运行DevTools,点击AcountsTester

clip_image001

你会看到一个新的账号类型将会同系统内置的“Corporate”类型的账号一样,被添加到列表中。尽管从下拉列表中选择你的账号,然后点击增加按钮,那么,将会呈现一个你所做的登录框。经过验证后 ,你的账号将会出现在按钮下边的列表中。在这一点,使用系统的“Account&sync”设置去移除和修改账户应该是安全的。

clip_image002 clip_image003

准备好“Data & synchronization”的章节了么?让我们开始第二个章节吧。

可供参考的实现源代码你可以从这里下载https://github.com/c99koder/lastfm-android/。(在GNUGeneralPublicLicense主题下边)另外一个单独的实例程序你可以从Apache License 2.0主题下得到https://github.com/c99koder/AndroidSyncProviderDemo。Google同样也有一个他们的示例的同步程序在Androiddeveloperportal http://developer.android.com/resources/samples/SampleSyncAdapter/index.html。该应用程序比我(原作者)的会稍微完整一些。



本文转自HDDevTeam 51CTO博客,原文链接:http://blog.51cto.com/hddev/653349,如需转载请自行联系原作者

相关文章
|
3月前
|
安全 Android开发 iOS开发
Android vs. iOS:构建生态差异与技术较量的深度剖析###
本文深入探讨了Android与iOS两大移动操作系统在构建生态系统上的差异,揭示了它们各自的技术优势及面临的挑战。通过对比分析两者的开放性、用户体验、安全性及市场策略,本文旨在揭示这些差异如何塑造了当今智能手机市场的竞争格局,为开发者和用户提供决策参考。 ###
|
4月前
|
存储 Java Android开发
探索安卓应用开发:构建你的第一个"Hello World"应用
【9月更文挑战第24天】在本文中,我们将踏上一段激动人心的旅程,深入安卓应用开发的奥秘。通过一个简单而经典的“Hello World”项目,我们将解锁安卓应用开发的基础概念和步骤。无论你是编程新手还是希望扩展技能的老手,这篇文章都将为你提供一次实操体验。从搭建开发环境到运行你的应用,每一步都清晰易懂,确保你能顺利地迈出安卓开发的第一步。让我们开始吧,探索如何将一行简单的代码转变为一个功能齐全的安卓应用!
|
28天前
|
Java Android开发 开发者
探索安卓开发:构建你的第一个“Hello World”应用
在安卓开发的浩瀚海洋中,每个新手都渴望扬帆起航。本文将作为你的指南针,引领你通过创建一个简单的“Hello World”应用,迈出安卓开发的第一步。我们将一起搭建开发环境、了解基本概念,并编写第一行代码。就像印度圣雄甘地所说:“你必须成为你希望在世界上看到的改变。”让我们一起开始这段旅程,成为我们想要见到的开发者吧!
35 0
|
3月前
|
Java API Android开发
安卓应用程序开发的新手指南:从零开始构建你的第一个应用
【10月更文挑战第20天】在这个数字技术不断进步的时代,掌握移动应用开发技能无疑打开了一扇通往创新世界的大门。对于初学者来说,了解并学习如何从无到有构建一个安卓应用是至关重要的第一步。本文将为你提供一份详尽的入门指南,帮助你理解安卓开发的基础知识,并通过实际示例引导你完成第一个简单的应用项目。无论你是编程新手还是希望扩展你的技能集,这份指南都将是你宝贵的资源。
95 5
|
3月前
|
前端开发 JavaScript 测试技术
Android适合构建中大型项目的架构模式全面对比
Android适合构建中大型项目的架构模式全面对比
54 2
|
3月前
|
开发工具 Android开发 iOS开发
Android vs iOS:构建移动应用时的关键考量####
本文深入探讨了Android与iOS两大移动平台在开发环境、性能优化、用户体验设计及市场策略方面的差异性,旨在为开发者提供决策依据。通过对比分析,揭示两个平台各自的优势与挑战,帮助开发者根据项目需求做出更明智的选择。 ####
|
3月前
|
调度 Android开发 开发者
构建高效Android应用:探究Kotlin多线程优化策略
【10月更文挑战第11天】本文探讨了如何在Kotlin中实现高效的多线程方案,特别是在Android应用开发中。通过介绍Kotlin协程的基础知识、异步数据加载的实际案例,以及合理使用不同调度器的方法,帮助开发者提升应用性能和用户体验。
68 4
|
3月前
|
编解码 Android开发 UED
构建高效Android应用:从内存优化到用户体验
【10月更文挑战第11天】本文探讨了如何通过内存优化和用户体验改进来构建高效的Android应用。介绍了使用弱引用来减少内存占用、懒加载资源以降低启动时内存消耗、利用Kotlin协程进行异步处理以保持UI流畅,以及采用响应式设计适配不同屏幕尺寸等具体技术手段。
58 2
|
4月前
|
开发框架 Android开发 iOS开发
探索安卓与iOS开发的差异:构建未来应用的指南
在移动应用开发的广阔天地中,安卓与iOS两大平台各占半壁江山。本文将深入浅出地对比这两大操作系统的开发环境、工具和用户体验设计,揭示它们在编程语言、开发工具以及市场定位上的根本差异。我们将从开发者的视角出发,逐步剖析如何根据项目需求和目标受众选择适合的平台,同时探讨跨平台开发框架的利与弊,为那些立志于打造下一个热门应用的开发者提供一份实用的指南。
73 5
|
4月前
|
开发工具 Android开发 iOS开发
探索安卓与iOS开发的差异:构建未来应用的关键考量
在数字时代的浪潮中,安卓和iOS这两大操作系统如同双子星座般耀眼夺目,引领着移动应用的潮流。它们各自拥有独特的魅力和深厚的用户基础,为开发者提供了广阔的舞台。然而,正如每枚硬币都有两面,安卓与iOS在开发过程中也展现出了截然不同的特性。本文将深入剖析这两者在开发环境、编程语言、用户体验设计等方面的显著差异,并探讨如何根据目标受众和项目需求做出明智的选择。无论你是初涉移动应用开发的新手,还是寻求拓展技能边界的资深开发者,这篇文章都将为你提供宝贵的见解和实用的建议,帮助你在安卓与iOS的开发之路上更加从容自信地前行。