中华万年历插件开发说明书.doc

中华万年历插件开发说明书江苏华易科技有限公司文件变更记录*A - 增加 M - 修订 D - 删除版本号日期变更类型编写评审批准变更摘要V12012-02-01A张浩杰初发版本目录1.概述32.请求接口32.1请求农历：32.2请求提醒：42.3请求天气42.4请求自定义程序53.插件开发53.1定义广播53.2注册广播63.3创建布局文件63.4绑定布局73.5时间更新71.概述本文档适用于中华万年历桌面插件的开发，该文档为客户端功能开发提供依据和参考。客户端端需按照本文档注明的功能点进行开发，并确保功能的可使用性。本文档以最新版为主，新版发布后旧版自动作废。2.请求接口请求前提：已安装中华万年历。2.1请求农历：Cursor cur=ctx.getContentResolver().query(Uri.parse(content:/vider/nongli/+todayString), null, null, null, null); if(cur!=null) Bundle bundle=cur.getExtras(); if(bundle!=null) widgetBean.year_n=bundle.getString(nong_year); widgetBean.month_n=bundle.getString(nong_month); widgetBean.date_n=bundle.getString(nong_date); widgetBean.year_gz=bundle.getString(nong_year_gz)+年; widgetBean.month_gz=bundle.getString(nong_month_gz)+月; widgetBean.date_gz=bundle.getString(nong_date_gz)+日; cur.close(); 参数描述：/nongli/：代表请求的是农历信息。todayString：必须为8位代表当前日期的数字，如：20100201。参数对应数据：nong_year：农历年nong_month：农历月nong_date：农历日nong_year_gz：农历年干支nong_month_gz：农历月干支nong_date_gz：农历日干支2.2请求提醒：Cursor cur=ctx.getContentResolver().query(Uri.parse(content:/vider/tixing/+todayString), null, null, null, null); if(cur!=null) Bundle bundle=cur.getExtras(); if(bundle!=null) widgetBean.tixing=bundle.getString(tixing); cur.close(); 参数描述：/tixing/：代表请求的是提醒信息。todayString：必须为8位代表当前日期的数字，如：20100201。参数对应数据：Tixing：包括日程、节日等信息。2.3请求天气Cursor cur=ctx.getContentResolver().query(Uri.parse(content:/vider/weather/+todayString+/+actionType), null, null, null, null);if(cur!=null) Bundle bundle=cur.getExtras(); if(bundle!=null) String resultCode=bundle.getString(resultCode); if(resultCode.equals(1000) widgetBean.city=bundle.getString(city); widgetBean.nowTemp=bundle.getString(nowTemp); else if(resultCode.equals(1001) /暂无数据 else if(resultCode.equals(1003) /当前只有一个城市 else /更新失败 cur.close(); 参数描述：/weather/：代表请求的是天气信息。todayString：必须为8位代表当前日期的数字，如：20100201。actionType：1代表获取当前城市天气，2代表刷新当前城市天气，3代表切换到下一个城市。参数对应数据：resultCode：返回参数，1000表示成功，1001表示暂无数据，1002表示当前只有一个城市，其他值表示更新失败。city：城市nowTemp：当前温度weather：天气信息2.4请求自定义程序Cursor cur=ctx.getContentResolver().query(Uri.parse(content:/vider/widgetSettings), null, null, null, null);if(cur!=null) Bundle bundle=cur.getExtras(); if(bundle!=null) startApplicationByPackageName(ctx, bundle.getString(packageName), null);MyPreferences.getInstance(ctx).setIsWidgetUse24Hours(bundle.getBoolean(IsWidgetUse24Hours); cur.close(); else startApplicationByPackageName(ctx,default, null); 参数描述：/widgetSettings:代表请求的是用户自定义信息。参数对应数据：packageName:插件自定义区域点击事件包名。IsWidgetUse24Hours：是否以24小时制显示时间。3.插件开发注：为了避免在Launcher中出现插件对应的程序，需把AndroidManifest.xml中Activity对应的ent.category.LAUNCHER属性去掉。3.1定义广播系统自带广播：注：系统自带的广播不能修改，修改后widget将无法接收。更新广播：android.appwidget.action.APPWIDGET_UPDATE关闭广播：android.appwidget.action.APPWIDGET_DISABLED中华万年历广播：注：中华万年历自带的广播不能修改，修改后widget将无法接收。日期、农历、提醒更新广播：CN.ETOUCH.ECALENDAR.FESTIVAL_TASK_HAS_CHANGED天气更新广播：CN.ETOUCH.ECALENDAR.WEATHER_HAS_UPDATE开发者自定义广播：注：用户自定义的广播必须修改，否则插件更新会出现问题。开发者通过自定义广播来实现对插件的更新，自定义广播格式参考如下：CN_ETOUCH_ECALENDAR_LJG_WEATHER_WIDGET_CHECK 包名 作者 用途 3.2注册广播在AndroidManifest.xml中注册自己widget中使用到的广播。如下：3.3创建布局文件创建布局，如下图：3.4绑定布局绑定控件，如下：RemoteViews widgetDayViews = new RemoteViews(context.getPackageName(),R.layout.weather_widget);widgetDayViews.setTextViewText(R.id.TextView05, widgetBean.tixing);widgetDayViews.setImageViewResource(R.id.ImageView_weather,widgetBean.weatherIconId);绑定事件，如下：Intent startPersionalPackage = new Intent(CN_ETOUCH_ECALENDAR_LJG_WEATHER_WIDGET_STARTPERSIONALPACKAGE);PendingIntent pending0 = PendingIntent.getBroadcast(context, 0,startPersionalPackage, 0);widgetDayViews.setOnClickPendingIntent(R.id.linearLayout6, pending0);3.5时间更新在某些情况下，时间的更新可能会出现问题，建议使用如下方法进行更新：启动时间更新：AlarmManager am = (AlarmManager) ctx.getSystemService(Context.ALARM_SERVICE);Intent intent = new Intent(CN_ETOUCH_ECALENDAR_LJG_WEATHER_WIDGET_CHECK);PendingIntent pendingIntent = PendingIntent.getBroadcast(ctx, 0,intent, 0);long interval = 1000 * 10;long firstWake =SystemClock.elapsedRealtime()+(10000-System.currentTimeMillis() % 10000);am.setRepeating(AlarmManager.ELAPSED_REALTIME,firstWake, interval, pendingIntent);注销时间更新：AlarmManager am = (AlarmManager) ctx.getSystemSer