美丽流畅的自定义加载视图

使用

<com.tuyenmonkey.mkloader.MKLoader

          android:layout_width="wrap_content"

          android:layout_height="wrap_content"

          app:mk_type="<loading_type>" (Optional. Default is ClassicSpinner)

          app:mk_color="<color>" (Optional. Default is #ffffff)

      />

类型

• Sharingan
• TwinFishesSpinner
• ClassicSpinner
• LineSpinner
• FishSpinner
• PhoneWave
• ThreePulse
• FourPulse
• FivePulse
• Worm
• Whirlpool
• Radar

安装

Gradle

dependencies {

  compile 'com.tuyenmonkey:mkloader:1.4.0'

}

github地址：https://github.com/nntuyen/mkloader

下载地址：master.zip

为什么要给程序瘦身？

随着应用程序的功能越来越多，实现越来越复杂，第三方库的引入，UI体验的优化等众多因素程序中的代码量成倍的增长，从而导致应用程序包的体积越来越大。当程序体积变大后不仅会出现编译流程变慢，而且还会出现运行性能问题，会增加应用下载时长和消耗用户的移动网络流量等等。因此在这些众多的问题下需要对应用进行瘦身处理。

一个应用程序由众多资源文件和可执行程序文件组成，资源文件的优化不在本文探讨范围。本文主要讨论对可执行程序代码瘦身的方法。

对可执行程序代码瘦身主要就是想办法让程序中不会被调用的源代码不参与编译或链接。我们可以通过一些源代码分析工具来查找哪些函数或者类方法没有被调用并从代码中删除掉来解决编译链接前的瘦身问题。这些分析工具也不在本文的讨论范围内。应用程序在编译时会对工程中的所有代码都执行编译处理并生成目标文件。而在链接阶段则会根据程序代码中对符号的引用关系来将所有相关的目标文件链接为一个大的可执行程序文件，并且在链接阶段链接器会优化掉所有没被调用的C/C++函数代码，但是对于OC类中的没有调用的方法则不会被优化掉。所以为了对可执行程序在编译链接阶段进行瘦身处理就需要了解源代码的编译链接规则。这也是本文所要介绍的针对工程通过静态库的形式进行编译和链接的方式来减少可执行程序代码的尺寸。您可以从文章：《深入iOS系统底层之静态库介绍》中详细的了解到静态库的编译链接过程，以及相关的技术细节。

一个瘦身的例子！

为了验证和具体的实践，我在github上建立了一个项目：YSAppSizeTest。您可以从这个项目中看到如何对工程进行构建以实现程序的瘦身处理。

在示例项目中同一个Workspace中分别建立ThinApp和FatApp两个工程，这两个工程实现的功能是一样。在整个应用程序中分别定义了CA、CB、CC、CD、CE一共5个OC类，定义了一个UIView(Test)分类，还有定义了两个C函数：libFoo1和libFoo1。

整个应用程序中只使用了CA和CC两个OC类，以及调用了UIView(Test)分类方法，以及调用了libFoo1函数，并且同时都采用导入静态库的形式。因为这两个工程对文件的定义和分布策略不同使得两个应用程序的最终可执行代码的尺寸是不相同的。

FatApp中的文件定义和分布策略

1、FatApp工程依赖并导入了FatAppLib静态库工程。
2、CA,CB两个类都定义在主程序工程中。
3、CC,CD,CE三个类，以及UIView(Test)分类，还有libFoo1,libFoo2两个函数都定义在FatAppLib静态库工程中。
4、CC,CD两个类定义在同一个文件中，CE类则定义在单独的文件中。
5、FatApp工程的Other Linker Flags中设置了 -ObjC选项。

ThinApp中的文件定义和分布策略

1、ThinApp工程依赖并导入了ThinAppLib静态库工程。
2、主程序工程就是一个壳工程。
3、CA,CB,CC,CD,CE5个类，以及UIView(Test)分类，还有libFoo1,libFoo2两个函数都定义在ThinAppLib静态库工程中。
4、上述的5个类都分别定义在不同的文件中。
5、ThinApp工程的Other Linker Flags中没有设置-ObjC选项。

上述两个工程的程序被Archive出来后，FatApp可执行程序的尺寸是367KB，而ThinApp可执行程序的尺寸是334KB。通过一些工具比如Mach-O View或者 IDA可以看出：FatApp中5个OC类的代码以及libFoo1函数还有UIView(Test)分类的代码都被链接进可执行程序中；而ThinApp中则只有CA,CC两个类以及libFoo1函数还有UIView(Test)分类的代码被链接进可执行程序中。在ThinApp中虽然没有使用-Objc链接选项，但是静态库中的分类也被链接进可执行程序中。

应用程序工程构建规则

根据对项目中的文件定义和引用策略以及相关的理论基础我们可以按照如下的规则来构建您的应用程序：

1、尽量将所有代码都移植到静态库中，而主程序则保留为一个壳程序。具体操作方法是建立一个Workspace，然后主程序工程就只有默认创建工程时的代码，所有新加入的代码都建立并存放到静态库工程中去，然后通过工程依赖来引入这些静态库工程，或者借助一些工程化工具比如Cocoapods来实现这种拆分和引用处理。主程序工程中只保留AppDelegate的代码，其他代码都一致到静态库中。然后在AppDelegate中的相关代码处调用静态库中定义的业务代码。

2、按业务组件对工程进行解耦每个组件是一个静态库工程。静态库中的每一个文件中最好只有一个类的实现，并且类的分类实现最好和类实现编写在同一个文件中，相同功能的代码以及可能都会被调用的代码尽量存放在一个文件中。

3、不要在主程序工程中使用-ObjC和-all_load两个选项而改为用-force_load 来单独指定要执行加载的静态库。-ObjC和-all_load选项会把主程序工程以及所依赖的所有静态库中的工程中的全部代码都链接到可执行程序中而不管代码是否有被调用过或者使用过。而force_load则只会将指定的静态库中的所有代码链接到可执行程序中，当然force_load如果没有必要也尽量不要使用。

4、尽量减少在静态库中定义OC类的分类方法，如果一定要定义分类方法则可以将分类方法定义在和类定义相同的文件中，或者将分类方法定义在一个一定会被调用和引用的实现文件中。因为根据链接规则静态库中的分类是不会被链接进可执行程序中的，除非使用了上述的三个链接选项。如果将分类代码单独的定义在一个文件中的话则可以通过在分类的头文件中定义一个内联函数，内联函数调用分类实现文件中的一个dumy函数,这样只要这个分类的头文件被include或者import就会把整个分类的实现链接到可执行程序中去。一般情况下我们在静态库中建立分类那就表明一定会被某个文件引用这个分类，从而实现整个文件的链接处理。在分类中定义的这两个函数则因为没有被任何地方调用，因此会在链接优化中将这两个函数给优化掉。这样就使得即使我们不用-ObjC选项也能将静态库中的分类链接到可执行程序中去。最后需要注意的是在每个分类中定义的这两个函数名最好能够唯一这样就不会出现符号重名冲突的问题了。

//分类文件的头文件UIView+XXX.h
@interface UIView (XXX)

//分类中定义的方法

@end

/*
  通过在分类的头文件中定义一个内联函数，内联函数调用分类实现文件中的一个dumy函数,这样只要这个分类的头文件被include或者import就会把
  整个分类的实现链接到可执行程序中去。一般情况下我们在静态库中建立分类那就表明一定会被某个文件引用这个分类，从而实现整个文件的链接处理。
  而在分类中定义的这两个函数则因为没有被任何地方调用，因此会在链接优化中将这两个函数给优化掉。这样就使得即使我们不用-ObjC选项也能
  将静态库中的分类链接到可执行程序中去。最后需要注意的是在每个分类中定义的这两个函数名最好能够唯一这样就不会出现符号重名冲突的问题了。
 */
extern void _cat_UIView_XXX_Impl(void);
inline void _cat_UIView_XXX_Decl(void){_cat_UIView_XXX_Impl();}


------------------------------------------------------------
//分类文件的实现文件UIView+XXX.m
#import "UIView+XXX.h"

@implementation UIView (XXX)

//分类的实现代码

@end

void _cat_UIView_XXX_Impl(void){}


---------------------------------------------------------------
//最后把这个分类头文件放入到某个对外暴露的头文件中，比如本例中将分类代码放入到了ThinAppLib.h文件中
//ThinAppLib.h

#import "UIView+XXX.h"
//其他头文件

5、除了可以通过-force_load来加载指定静态库中的所有代码外。我们还可以在构建静态库时，在静态库的工程的Build Settings中将Perform Single-Object Prelink 中的开关选项打开。当这个开关打开时，系统会对生成的静态库的所有目标文件执行预链接操作，预链接操作会将所有的目标文件组合成为一个单独的大的目标文件。这样根据以文件为单位的链接规则就会将静态库中的所有代码全部都链接进可执行程序中去，但是这样带来的问题就是最后在dead code stripping时删除不掉已经链接进来的那些没有被任何地方使用过的OC类了。

6、对于引入的一些第三方静态库或者第三方的开源库来说因为我们无法去改变其实现逻辑。如果这个静态库中没有任何分类代码的定义则正常引用即可，如果静态库中有分类方法的定义则单独对这个静态库采用-force_load选项。

总之一句话：为了让你的程序瘦身，尽量将代码放到静态库中，不要使用-Objc和-all_load选项

为了验证上述方法的有效性，笔者对项目中的应用做了一个测试：分别是有带-ObjC选项和没有带-ObjC选项的情况下的应用程序包中可执行程序的大小从115M减少到95M，减少了20M的尺寸。

链接：https://www.jianshu.com/p/2078e00891fd

ChatKit 开源且提供完全自由的授权协议，开发者可以对其进行任意修改、扩展和二次封装，但是 LeanCloud 并不对 ChatKit 的二次开发提供技术支持。

获取项目

git clone git@github.com:leancloud/LeanCloudChatKit-Android.git

运行 Demo

获取源代码之后，用 Android Studio 打开项目，左侧的 Project 视图显示为：

「ChatKit-Android」Project 包含两个模块：

• leancloudchatkit
  
  是一个封装了 LeanCloud 即时通讯的 UI lib，其目的是让开发者更快速地接入 LeanCloud 即时通讯的功能。


• chatkitapplication
  
  为 Demo 项目，它是一个简单的示例项目，用来指导开发者如何使用 leancloudchatkit。

然后，请确保电脑上已经连接了一台真机或者虚拟机用作调试。

点击 Debug 或者 Run，第一次启动会运行 Gradle Build。建议打开全局网络代理，否则 Gradle Build 可能会因为网络原因无法完成。

使用方法

开发者可以将 ChatKit 导入到自己的 Project 中使用。下面我们将新建一个 Project（名为 ChatDemo） 用以导入 ChatKit。导入方式推荐通过源代码导入。

源代码导入

1. 浏览器访问 https://github.com/leancloud/LeanCloudChatKit-Android；


2. 执行以下命令行，将项目 clone 到本地（如 ChatKit 文件夹中，或者直接下载 zip 包自行解压缩到此文件夹下）：

   git clone https://github.com/leancloud/LeanCloudChatKit-Android.git`
   

   
   


3. 将文件夹 leancloudchatkit 复制到 ChatDemo 根目录；


4. 修改 ChatDemo/settings.gradle 加入 include ':leancloudchatkit'；


5. 修改 ChatDemo/app/build.gradle，在 dependencies 中添加 compile project(":leancloudchatkit")。

最后只要 Sync Project，这样 ChatKit 就算是导入到项目中了。

自定义使用

一、实现自己的 Application

ChatKit 在使用之前需要进行初始化，就像直接使用 LeanCloud 基础 SDK 时需要调用 AVOSCloud.initialize(appId, appKey) 一样。初始化逻辑应该放在 Application.onCreate 方法中实现。

ChatDemo 中新建一个 Class，名字叫做 ChatDemoApplication，让它继承自 Application 类，代码如下：

public class ChatDemoApplication extends Application {



// appId、appKey 可以在「LeanCloud  控制台 > 设置 > 应用 Key」获取

  private final String APP_ID = "********";

  private final String APP_KEY = "********";



  @Override

  public void onCreate() {

    super.onCreate();

    // 关于 CustomUserProvider 可以参看后面的文档

    LCChatKit.getInstance().setProfileProvider(CustomUserProvider.getInstance());

    LCChatKit.getInstance().init(getApplicationContext(), APP_ID, APP_KEY);

  }

}

二、在 AndroidMainfest.xml 中配置 ChatDemoApplication

<application

  ...

  android:name=".ChatDemoApplication" >

  ...

</application>

三、实现自己的用户体系

一般来说，聊天界面要相对复杂一些，不但要支持文字、表情、图片、语音等消息格式，还要展示用户信息，比如用户的头像、昵称等。而 LeanCloud 的消息流中只包含用户的 clientId 这一唯一标识，所以要获取头像这类额外的用户信息，就需要开发者接入自己的用户系统来实现。

为了保证通用性和扩展性，让开发者可以更容易将聊天界面嵌入自己的应用中，ChatKit 在设计上抽象出了一个「用户体系」的接口，需要开发者自己提供用户信息的获取方式。该接口只有一个方法需要开发者实现：

/**

 * 用户体系的接口，开发者需要实现此接口来接入 LCChatKit

 */

public interface LCChatProfileProvider {

  // 根据传入的 clientId list，查找、返回用户的 Profile 信息(id、昵称、头像)

  public void fetchProfiles(List<String> userIdList, LCChatProfilesCallBack profilesCallBack);

}

为此，我们在 ChatDemo 中新建一个 Class，名字叫做 CustomUserProvider，代码如下：

public class CustomUserProvider implements LCChatProfileProvider {



  private static CustomUserProvider customUserProvider;



  public synchronized static CustomUserProvider getInstance() {

    if (null == customUserProvider) {

      customUserProvider = new CustomUserProvider();

    }

    return customUserProvider;

  }



  private CustomUserProvider() {

  }



  private static List<LCChatKitUser> partUsers = new ArrayList<LCChatKitUser>();



  // 此数据均为模拟数据，仅供参考

  static {

    partUsers.add(new LCChatKitUser("Tom", "Tom", "http://www.avatarsdb.com/avatars/tom_and_jerry2.jpg"));

    partUsers.add(new LCChatKitUser("Jerry", "Jerry", "http://www.avatarsdb.com/avatars/jerry.jpg"));

    partUsers.add(new LCChatKitUser("Harry", "Harry", "http://www.avatarsdb.com/avatars/young_harry.jpg"));

    partUsers.add(new LCChatKitUser("William", "William", "http://www.avatarsdb.com/avatars/william_shakespeare.jpg"));

    partUsers.add(new LCChatKitUser("Bob", "Bob", "http://www.avatarsdb.com/avatars/bath_bob.jpg"));

  }



  @Override

  public void fetchProfiles(List<String> list, LCChatProfilesCallBack callBack) {

    List<LCChatKitUser> userList = new ArrayList<LCChatKitUser>();

    for (String userId : list) {

      for (LCChatKitUser user : partUsers) {

        if (user.getUserId().equals(userId)) {

          userList.add(user);

          break;

        }

      }

    }

    callBack.done(userList, null);

  }



  public List<LCChatKitUser> getAllUsers() {

    return partUsers;

  }

}

当用户昵称和头像需要更新时，需要覆盖旧的 LCChatKitUser 对象并更新本地缓存：

    LCChatKitUser user = new LCChatKitUser("唯一 userId 不可变", "要变更的昵称", "要变更的 avatarURL");

    LCIMProfileCache.getInstance().cacheUser(user);

四、打开即时通讯，并且跳转到聊天页面

我们支持通过两种方式来打开聊天界面：

1. 通过指定另一个参与者的 clientId 的方式，开启一对一的聊天；
   
   此时，通过调用 intent.putExtra(LCIMConstants.PEER_ID, "peermemberId") 来传递另一参与者的 clientId。


2. 通过指定一个已经存在的 AVIMConversation id 的方式，开启单人、多人或者开放式聊天室；
   
   此时，通过调用 LCIMConstants.CONVERSATION_ID, "particularConversationId") 来传递特定对话 Id。

下面的代码展示了如何通过第一种方式来开启聊天界面：

LCChatKit.getInstance().open("Tom", new AVIMClientCallback() {

      @Override

      public void done(AVIMClient avimClient, AVIMException e) {

        if (null == e) {

          finish();

          Intent intent = new Intent(MainActivity.this, LCIMConversationActivity.class);

          intent.putExtra(LCIMConstants.PEER_ID, "Jerry");

          startActivity(intent);

        } else {

          Toast.makeText(MainActivity.this, e.toString(), Toast.LENGTH_SHORT).show();

        }

      }

    });

这样，Tom 就可以和 Jerry 愉快地聊天了。

接口以及组件

以下介绍在 ChatKit 中开发者常需要关注的业务逻辑组件（Interface）和界面组件（UI）。

用户

LCChatKitUser 是 ChatKit 封装的参与聊天的用户，它提供了如下属性：

使用这些默认的属性基本可以满足一个聊天应用的需求，同时开发者可以通过继承 LCChatKitUser 类实现更多属性。具体用法请参考 Demo 中的 MembersAdapter.java。

用户信息管理类

LCChatProfileProvider 接口需要用户 implements 后实现 fetchProfiles 函数，以使 ChatKit 在需要显示的时候展示用户相关的信息。

例如 Demo 中的 CustomUserProvider 这个类，它实现了 LCChatProfileProvider 接口，在 fetchProfiles 方法里加载了 Tom、Jerry 等人的信息。

核心类

LCChatKit 是 ChatKit 的核心类，具体逻辑可以参看代码，注意以下几个主要函数：

public void init(Context context, String appId, String appKey)

此函数用于初始化 ChatKit 的相关设置，此函数要在 Application 的 onCreate 中调用，否则可能会引起异常。

public void setProfileProvider(LCChatProfileProvider profileProvider)

此函数用于设置用户体系，因为 LeanCloud 即时通讯功能已经实现了完全剥离用户体系的功能，这里接入已有的用户体系会很方便。

public void open(final String userId, final AVIMClientCallback callback)

此函数用于开始即时通讯，open 成功后可以执行自己的逻辑，或者跳转到聊天页面。

对话列表界面

对话 AVIMConversation 是 LeanMessage 封装的用来管理对话中的成员以及发送消息的载体，不论是群聊还是单聊都是在一个对话当中；而对话列表可以作为聊天应用默认的首页显示出来，主流的社交聊天软件，例如微信，就是把最近的对话列表作为登录后的首页。

因此，我们也提供了对话列表 LCIMConversationListFragment 页面供开发者使用，在 Demo 项目中的 MainActivity 中的 initTabLayout 方法中演示了如何引入对话列表页面：

  private void initTabLayout() {

    String[] tabList = new String[]{"会话", "联系人"};

    final Fragment[] fragmentList = new Fragment[] {new LCIMConversationListFragment(),

            new ContactFragment()};

    // 以上这段代码为新建了一个 Fragment 数组，并且把 LCIMConversationListFragment 作为默认显示的第一个 Tab 页面



    tabLayout.setTabMode(TabLayout.MODE_FIXED);

    for (int i = 0; i < tabList.length; i++) {

      tabLayout.addTab(tabLayout.newTab().setText(tabList[i]));

    }

    ...

}

具体的显示效果如下：

聊天界面

聊天界面是显示频率最高的前端页面，ChatKit 通过 LCIMConversationFragment 和 LCIMConversationActivity 来实现这一界面。在 Demo 的 ContactItemHolder 界面包含了使用 LCIMConversationActivity 的实例：

  public void initView() {

    nameView = (TextView)itemView.findViewById(R.id.tv_friend_name);

    avatarView = (ImageView)itemView.findViewById(R.id.img_friend_avatar);



    itemView.setOnClickListener(new View.OnClickListener() {

      @Override

      public void onClick(View v) {

        // 点击联系人，直接跳转进入聊天界面 

        Intent intent = new Intent(getContext(), LCIMConversationActivity.class);

        // 传入对方的 Id 即可

        intent.putExtra(LCIMConstants.PEER_ID, lcChatKitUser.getUserId());

        getContext().startActivity(intent);

      }

    });

  }

具体的显示效果如下：

联系人列表页面

因为 ChatKit 是与应用的用户体系完全解耦的，所以 ChatKit 中并没有包含联系人列表页面，但部分开发者可能有此需求，所以 chatkitapplication 实现了一个基于 LCChatProfileProvider 的联系人列表页面，具体代码可以参考 ContactFragment.java，
具体效果如下：

常见问题

ChatKit 组件收费么？

ChatKit 是完全开源并且免费给开发者使用，使用聊天所产生的费用以账单为准。

接入 ChatKit 有什么好处？

它可以减轻应用或者新功能研发初期的调研成本，直接引入使用即可。ChatKit 从底层到 UI 提供了一整套的聊天解决方案。

alerter克服了toast和snackbar的缺点，并布局很简单

生成

为了简单起见，Alerter采用了builder模式，以便于轻松集成到任何应用程序中。

可自定义的警报视图将动态添加到窗口的装饰视图中，覆盖所有内容。

安装配置

allprojects {

 repositories {

    jcenter()

    maven { url "https://jitpack.io" }

 }

}

build.gradle

dependencies {

    implementation 'com.github.tapadoo:alerter:$current-version'

}

使用

Activity -

Alerter.create(this@DemoActivity)

       .setTitle("Alert Title")

       .setText("Alert text...")

       .show()

Fragment -

Alerter.create(activity)

       .setTitle("Alert Title")

       .setText("Alert text...")

       .show()

展示 -

Alerter.isShowing()

隐藏 -

Alerter.hide()

定制

背景颜色

Alerter.create(this@DemoActivity)

       .setTitle("Alert Title")

       .setText("Alert text...")

       .setBackgroundColorRes(R.color.colorAccent) // or setBackgroundColorInt(Color.CYAN)

       .show()

图标

Alerter.create(this@DemoActivity)

       .setText("Alert text...")

       .setIcon(R.drawable.alerter_ic_mail_outline)

       .setIconColorFilter(0) // Optional - Removes white tint

       .setIconSize(R.dimen.custom_icon_size) // Optional - default is 38dp

       .show()

自定义屏幕持续时间（毫秒）

Alerter.create(this@DemoActivity)

       .setTitle("Alert Title")

       .setText("Alert text...")

       .setDuration(10000)

       .show()

无标题

Alerter.create(this@DemoActivity)

       .setText("Alert text...")

       .show()

添加 Click Listener

 Alerter.create(this@DemoActivity)

        .setTitle("Alert Title")

        .setText("Alert text...")

        .setDuration(10000)

        .setOnClickListener(View.OnClickListener {

            Toast.makeText(this@DemoActivity, "OnClick Called", Toast.LENGTH_LONG).show();

        })

        .show()

长的文本

 Alerter.create(this@DemoActivity)

        .setTitle("Alert Title")

        .setText("The alert scales to accommodate larger bodies of text. " +

                 "The alert scales to accommodate larger bodies of text. " +

                 "The alert scales to accommodate larger bodies of text.")

        .show()

自定义进入/退出动画

  Alerter.create(this@KotlinDemoActivity)

         .setTitle("Alert Title")

         .setText("Alert text...")

         .setEnterAnimation(R.anim.alerter_slide_in_from_left)

         .setExitAnimation(R.anim.alerter_slide_out_to_right)

         .show()

可见性回调

 Alerter.create(this@KotlinDemoActivity)

        .setTitle("Alert Title")

        .setText("Alert text...")

        .setDuration(10000)

        .setOnShowListener(OnShowAlertListener {

            Toast.makeText(this@KotlinDemoActivity, "Show Alert", Toast.LENGTH_LONG).show()

        })

        .setOnHideListener(OnHideAlertListener {

            Toast.makeText(this@KotlinDemoActivity, "Hide Alert", Toast.LENGTH_LONG).show()

        })

        .show()

自定义字体和文本外观

 Alerter.create(this@DemoActivity)

        .setTitle("Alert Title")

        .setTitleAppearance(R.style.AlertTextAppearance_Title)

        .setTitleTypeface(Typeface.createFromAsset(getAssets(), "Pacifico-Regular.ttf"))

        .setText("Alert text...")

        .setTextAppearance(R.style.AlertTextAppearance_Text)

        .setTextTypeface(Typeface.createFromAsset(getAssets(), "ScopeOne-Regular.ttf"))

        .show()

退出

 Alerter.create(this@DemoActivity)

        .setTitle("Alert Title")

        .setText("Alert text...")

        .enableSwipeToDismiss()

        .show()

Progress Bar

 Alerter.create(this@DemoActivity)

        .setTitle("Alert Title")

        .setText("Alert text...")

        .enableProgress(true)

        .setProgressColorRes(R.color.colorAccent)

        .show()

带按钮

 Alerter.create(this@KotlinDemoActivity)

        .setTitle(R.string.title_activity_example)

        .setText("Alert text...")

        .addButton("Okay", R.style.AlertButton, View.OnClickListener {

            Toast.makeText(this@KotlinDemoActivity, "Okay Clicked", Toast.LENGTH_LONG).show()

        })

        .addButton("No", R.style.AlertButton, View.OnClickListener {

            Toast.makeText(this@KotlinDemoActivity, "No Clicked", Toast.LENGTH_LONG).show()

        })

        .show()

自定义layout

 Alerter.create(this@KotlinDemoActivity, R.layout.custom_layout)

        .setBackgroundColorRes(R.color.colorAccent)

        .also { alerter ->

            val tvCustomView = alerter.getLayoutContainer()?.tvCustomLayout

            tvCustomView?.setText(R.string.with_custom_layout)

        }

        .show()

github地址：https://github.com/Tapadoo/Alerter
下载地址：master.zip

对于平常的应用程序开发，我们很少需要关注编译和链接过程。我们平常Xcode开发就是集成的的开发环境（IDE）,这样的IDE一般都将编译和链接的过程一步完成，通常将这种编译和链接合并在一起的过程称为构建，即使使用命令行来编译一个源代码文件,简单的一句gcc hello.c命令就包含了非常复杂的过程!

正是因为集成开发环境的强大，很多系统软件的运行机制与机理被掩盖，其程序的很多莫名其妙的错误让我们无所适从，面对程序运行时种种性能瓶颈我们束手无策。我们看到的是这些问题的现象，但是却很难看清本质，所有这些问题的本质就是软件运行背后的机理及支撑软件运行的各种平台和工具，如果能深入了解这些机制，那么解决这些问题就能够游刃有余，收放自如了。

编译流程分析
现在我们通过一个C语言的经典例子，来具体了解一下这些机制：

#include <stdio.h>
int main(){
    printf("Hello World");
    return 0;
}

在linux下只需要一个简单的命令（假设源代码文件名为hello.c）：

$ gcc hello.c
$ ./a.out
Hello World

其实上述过程可以分解为四步:

1、预处理（Prepressing）
2、编译（Compilation）
3、汇编（Assembly）
4、链接（Linking）

预编译
首先是源代码文件hello.c和相关的头文件（如stdio.h等）被预编译器cpp预编译成一个.i文件。第一步预编译的过程相当于如下命令（-E 表示只进行预编译）：

$ gcc –E hello.c –o hello.i

还可以下面的表达

$ cpp hello.c > hello.i

预编译过程主要处理源代码文件中以”#”开头的预编译指令。比如#include、#define等，主要处理规则如下：

1、将所有的#define删除，并展开所有的宏定义
2、处理所有条件预编译指令，比如#if，#ifdef，#elif，#else，#endif
3、处理#include预编译指令，将被包含的文件插入到该预编译指令的位置。
4、删除所有的注释//和/**/
5、添加行号和文件名标识，比如#2 “hello.c” 2。
6、保留所有的#pragma编译器指令
截图个大家看看效果

经过预编译后的文件（.i文件）不包含任何宏定义，因为所有的宏已经被展开，并且包含的文件也已经插入到.i文件中，所以当我们无法判断宏定义是否正确或头文件包含是否正确时，可以查看预编译后的文件来确定问题。

编译（compliation）
编译过程就是把预处理完的文件进行一系列的：词法分析、语法分析、语义分析及优化后生产相应的汇编代码文件，此过程是整个程序构建的核心部分，也是最复杂的部分之一。其编译过程相当于如下命令：

$ gcc –S hello.i –o hello.s

通过上图我们不难得出，通过命令得到汇编输出文件hello.s.

汇编（assembly）
汇编器是将汇编代码转变成机器可以执行的指令，每一个汇编语句几乎对应一条机器令。所以汇编器的汇编过程相对于编译器来讲比较简单，它没复杂的语法，也没有语义，也不需要做指令优化，只是根据汇编指令和机器指令的对照表一一翻译就可以了。其汇编过程相当于如下命令：

as hello.s –o hello.o

或者

gcc –c hello.s –o hello.o

或者使用gcc命令从C源代码文件开始，经过预编译、编译和汇编直接输出目标文件：

gcc –c hello.c –o hello.o

链接（linking）
链接通常是一个让人比较费解的过程，为什么汇编器不直接输出可执行文件而是输出一个目标文件呢？为什么要链接？下面让我们来看看怎么样调用ld才可以产生一个能够正常运行的Hello World程序：

注意默认情况没有gcc / 记得 ：
$ brew install gcc

链接相应的库

下面在贴出我们的写出的源代码是如何变成目标代码的流程图：

主要通过我们的编译器做了以下任务：扫描、语法分析、语义分析、源代码优化、代码生成和目标代码优化

到这我们就可以得到以下的文件，不知道你是否有和我一起操作，玩得感觉还是不错，继续往下面看

iOS的编译器
iOS现在为了达到更牛逼的速度和优化效果，采用了LLVM

1.LLVM核心库:
LLVM提供一个独立的链接代码优化器为许多流行CPU（以及一些不太常见的CPU）的代码生成支持。这些库是围绕一个指定良好的代码表示构建的，称为LLVM中间表示（“LLVM IR”）。LLVM还可以充当JIT编译器 - 它支持x86 / x86_64和PPC / PPC64程序集生成，并具有针对编译速度的快速代码优化。。

2.LLVM IR 生成器Clang: Clang是一个“LLVM原生”C / C ++ / Objective-C编译器，旨在提供惊人的快速编译（例如，在调试配置中编译Objective-C代码时比GCC快3倍），非常有用的错误和警告消息以及提供构建优秀源代码工具的平台。

3.LLDB项目:
LLDB项目以LLVM和Clang提供的库为基础，提供了一个出色的本机调试器。它使用Clang AST和表达式解析器，LLVM JIT，LLVM反汇编程序等，以便提供“正常工作”的体验。在加载符号时，它也比GDB快速且内存效率更高。

4.libc和libc++:
libc 和libc++ ABI项目提供了C ++标准库的标准符合性和高性能实现，包括对C ++ 11的完全支持。

5.lld项目:
lld项目旨在成为clang / llvm的内置链接器。目前，clang必须调用系统链接器来生成可执行文件。

LLVM采用三相设计，前端Clang负责解析，验证和诊断输入代码中的错误，然后将解析的代码转换为LLVM IR，后端LLVM编译把IR通过一系列改进代码的分析和优化过程提供，然后被发送到代码生成器以生成本机机器代码。

编译器前端的任务是进行：

1、语法分析
2、语义分析
3、生成中间代码(intermediate representation )

在这个过程中，会进行类型检查，如果发现错误或者警告会标注出来在哪一行。

以上图解内容所做的是事情和gcc编译一模模一样样！

iOS程序-详细编译过程
1.写入辅助文件：将项目的文件结构对应表、将要执行的脚本、项目依赖库的文件结构对应表写成文件，方便后面使用；并且创建一个 .app 包，后面编译后的文件都会被放入包中；
2.运行预设脚本：Cocoapods 会预设一些脚本，当然你也可以自己预设一些脚本来运行。这些脚本都在 Build Phases中可以看到；
3.编译文件：针对每一个文件进行编译，生成可执行文件 Mach-O，这过程 LLVM 的完整流程，前端、优化器、后端；
4.链接文件：将项目中的多个可执行文件合并成一个文件；
5.拷贝资源文件：将项目中的资源文件拷贝到目标包；
6.编译 storyboard 文件：storyboard 文件也是会被编译的；
7.链接 storyboard 文件：将编译后的 storyboard 文件链接成一个文件；
8.编译 Asset 文件：我们的图片如果使用 Assets.xcassets 来管理图片，那么这些图片将会被编译成机器码，除了 icon 和 launchImage；
9.运行 Cocoapods 脚本：将在编译项目之前已经编译好的依赖库和相关资源拷贝到包中。
10.生成 .app 包
11.将 Swift 标准库拷贝到包中
12.对包进行签名
13.完成打包

链接：https://www.jianshu.com/p/b60612c4d9ca

我们不是迷信测试，但它应该帮助我们加快开发进度，并且让事情变得更有趣。

让事情保持简单

测试简单的事情很简单，同样，测试复杂的事会很复杂。就像我们在其他文章中指出的那样，让事情保持简单小巧总是好的。除此之外，它还有利于我们测试。这是件双赢的事。让我们来看看测试驱动开发（简称 TDD），有些人喜欢它，有些人则不喜欢。我们在这里不深入讨论，只是如果用 TDD，你得在写代码之前先写好测试。如果你好奇的话，可以去找 Wikipedia 上的文章看看。同时，我们也认为重构和测试可以很好地结合在一起。

测试 UI 部分通常很麻烦，因为它们包含太多活动部件。通常，view controller 需要和大量的 model 和 view 类交互。为了使 view controller 便于测试，我们要让任务尽量分离。

幸好，我们在更轻量的 view controller 这篇文章中的阐述的技术可以让测试更加简单。通常，如果你发现有些地方很难做测试，这就说明你的设计出了问题，你应该重构它。你可以重新参考更轻量的 view controller 这篇文章来获得一些帮助。总的目标就是有清晰的关注点分离。每个类只做一件事，并且做好。这样就可以让你只测试这件事。

记住：测试越多，回报的增长趋势越慢。首先你应该做简单的测试。当你觉得满意时，再加入更多复杂的测试。

Mocking

当你把一个整体拆分成小零件（比如更小的类）时，我们可以针对每个小的类来进行测试。但由于我们测试的类会和其他类交互，这里我们用一个所谓的 mock 或 stub 来绕开它。把 mock 对象看成是一个占位符，我们测试的类会跟这个占位符交互，而不是真正的那个对象。这样，我们就可以针对性地测试，并且保证不依赖于应用程序的其他部分。

在示例程序中，我们有个包含数组的 data source 需要测试。这个 data source 会在某个时候从 table view 中取出（dequeue）一个 cell。在测试过程中，还没有 table view，但是我们传递一个 mock 的 table view，这样即使没有 table view，也可以测试 data source，就像下面你即将看到的。起初可能有点难以理解，多看几次后，你就能体会到它的强大和简单。

Objective-C 中有个用来 mocking 的强大工具叫做 OCMock。它是一个非常成熟的项目，充分利用了 Objective-C 运行时强大的能力和灵活性。它使用了一些很酷的技巧，让通过 mock 对象来测试变得更加有趣。

本文后面有 data source 测试的例子，它更加详细地展示了这些技术如何工作在一起。

SenTestKit

编者注 这一节有一些过时了。在 Xcode 5 中 SenTestingKit 已经被 XCTest 完全取代，不过两者使用上没有太多区别，我们可以通过 Xcode 的 Edit -> Refactor -> Convert to XCTest 选项来切换到新的测试框架

我们将要使用的另一个工具是一个测试框架，开发者工具的一部分：Sente 的 SenTestingKit。这个上古神器从 1997 年起就伴随在 Objective-C 开发者左右，比第一款 iPhone 发布还早 10 年。现在，它已经集成到 Xcode 中了。SenTestingKit 会运行你的测试。通过 SenTestingKit，你将测试组织在类中。你需要给每一个你想测试的类创建一个测试类，类名以 Tests 结尾，它反应了这个类是干什么的。

这些测试类里的方法会做具体的测试工作。方法名必须以 test 开头来作为触发一个测试运行的条件。还有特殊的 -setUp 和 -tearDown 方法，你可以重载它们来设置各个测试。记住，你的测试类就是个类而已：只要对你有帮助，可以按需求在里面加 properties 和辅助方法。

做测试时，为测试类创建基类是个不错的模式。把通用的逻辑放到基类里面，可以让测试更简单和集中。可以通过示例程序中的例子来看看这样带来的好处。我们没有使用 Xcode 的测试模板，为了让事情简单有效，我们只创建了单独的 .m 文件。通过把类名改成以 Tests 结尾，类名可以反映出我们在对什么做测试。

编者注 Xcode 5 中 默认的测试模板也不再会自动创建 .h 文件了

与 Xcode 集成

测试会被 build 成一个 bundle，其中包含一个动态库和你选择的资源文件。如果你要测试某些资源文件，你得把它们加到测试的 target 中，Xcode 就会将它们打包到一个 bundle 中。接着你可以通过 NSBundle 来定位这些资源文件，示例项目实现了一个 -URLForResource:withExtension: 方法来方便的使用它。

Xcode 中的每个 scheme 定义了相应的测试 bundle 是哪个。通过 ⌘-R 运行程序，⌘-U 运行测试。

测试的运行依附于程序的运行，当程序运行时，测试 bundle 将被注入（injected）。测试时，你可能不想让你的程序做太多的事，那样会对测试造成干扰。可以把下面的代码加到 app delegate 中：

static BOOL isRunningTests(void) __attribute__((const));

- (BOOL)application:(UIApplication *)application
        didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
    if (isRunningTests()) {
        return YES;
    }

    //
    // Normal logic goes here
    //

    return YES;
}

static BOOL isRunningTests(void)
{
    NSDictionary* environment = [[NSProcessInfo processInfo] environment];
    NSString* injectBundle = environment[@"XCInjectBundle"];
    return [[injectBundle pathExtension] isEqualToString:@"octest"];
}

编辑 Scheme 给了你极大的灵活性。你可以在测试之前或之后运行脚本，也可以有多个测试 bundle。这对大型项目来说很有用。最重要的是，可以打开或关闭个别测试，这对调试测试非常有用，只是要记得之后再把它们重新全部打开。

还要记住你可以为测试代码下断点，当测试执行时，调试器会在断点处停下来。

测试 Data Source
好了，让我们开始吧。我们已经通过拆分 view controller 让测试工作变得更轻松了。现在我们要测试 ArrayDataSource。首先我们新建一个空的，基本的测试类。我们把接口和实现都放到一个文件里；也没有哪个地方需要包含 @interface，放到一个文件会显得更加漂亮和整洁。

#import "PhotoDataTestCase.h"

@interface ArrayDataSourceTest : PhotoDataTestCase
@end

@implementation ArrayDataSourceTest
- (void)testNothing;
{
    STAssertTrue(YES, @"");
}
@end

这个类没做什么事，只是展示了基本的设置。当我们运行这个测试时，-testNothing 方法将会运行。特别地，STAssert宏将会做琐碎的检查。注意，前缀 ST 源自于 SenTestingKit。这些宏和Xcode 集成，会把失败显示到侧边面板的Issues导航栏中。

第一个测试

我们现在把 testNothing 替换成一个简单、真正的测试：

- (void)testInitializing;
{
    STAssertNil([[ArrayDataSource alloc] init], @"Should not be allowed.");
    TableViewCellConfigureBlock block = ^(UITableViewCell *a, id b){};
    id obj1 = [[ArrayDataSource alloc] initWithItems:@[]
                                      cellIdentifier:@"foo"
                                  configureCellBlock:block];
    STAssertNotNil(obj1, @"");
}

接着，我们想测试ArrayDataSource实现的方法：

- (UITableViewCell *)tableView:(UITableView *)tableView
         cellForRowAtIndexPath:(NSIndexPath *)indexPath;

为此，我们创建一个测试方法：

- (void)testCellConfiguration;

首先，创建一个 data source：

__block UITableViewCell *configuredCell = nil;
__block id configuredObject = nil;
TableViewCellConfigureBlock block = ^(UITableViewCell *a, id b){
    configuredCell = a;
    configuredObject = b;
};
ArrayDataSource *dataSource = [[ArrayDataSource alloc] initWithItems:@[@"a", @"b"]
                                                      cellIdentifier:@"foo"
                                                  configureCellBlock:block];

注意，configureCellBlock 除了存储对象以外什么都没做，这可以让我们可以更简单地测试它。

然后，我们为 table view 创建一个 mock 对象：

id mockTableView = [OCMockObject mockForClass:[UITableView class]];

Data source 将在传进来的 table view 上调用 -dequeueReusableCellWithIdentifier:forIndexPath: 方法。我们将告诉 mock object 当它收到这个消息时要做什么。首先创建一个 cell，然后设置 mock。

UITableViewCell *cell = [[UITableViewCell alloc] init];
NSIndexPath* indexPath = [NSIndexPath indexPathForRow:0 inSection:0];
[[[mockTableView expect] andReturn:cell]
        dequeueReusableCellWithIdentifier:@"foo"
                             forIndexPath:indexPath];

第一次看到它可能会觉得有点迷惑。我们在这里所做的，是让 mock 记录特定的调用。Mock 不是一个真正的 table view；我们只是假装它是。-expect 方法允许我们设置一个 mock，让它知道当这个方法调用时要做什么。

另外，-expect 方法也告诉 mock 这个调用必须发生。当我们稍后在 mock 上调用 -verify 时，如果那个方法没有被调用过，测试就会失败。相应地，-stub 方法也用来设置 mock 对象，但它不关心方法是否被调用过。

现在，我们要触发代码运行。我们就调用我们希望测试的方法。

NSIndexPath* indexPath = [NSIndexPath indexPathForRow:0 inSection:0];
id result = [dataSource tableView:mockTableView
            cellForRowAtIndexPath:indexPath];

然后我们测试是否一切正常：

STAssertEquals(result, cell, @"Should return the dummy cell.");
STAssertEquals(configuredCell, cell, @"This should have been passed to the block.");
STAssertEqualObjects(configuredObject, @"a", @"This should have been passed to the block.");
[mockTableView verify];

STAssert宏测试值的相等性。注意，前两个测试，我们通过比较指针来完成；我们不使用-isEqual:，是因为我们实际希望测试的是result，cell和configuredCell都是同一个对象。第三个测试要用 -isEqual:，最后我们调用 mock的 -verify方法。

注意，在示例程序中，我们是这样设置 mock 的：

id mockTableView = [self autoVerifiedMockForClass:[UITableView class]];

这是我们测试基类中的一个方便的封装，它会在测试最后自动调用 -verify 方法。

测试 UITableViewController
下面，我们转向PhotosViewController。它是个 UITableViewController 的子类，它使用了我们刚才测试过的 data source。View controller 剩下的代码已经相当简单了。

我们想测试点击 cell 后把我们带到详情页面，即一个 PhotoViewController的实例被 push 到 navigation controller 里面。我们再次使用 mocking 来让测试尽可能不依赖于其他部分。

首先我们创建一个 UINavigationController 的 mock：

id mockNavController = [OCMockObject mockForClass:[UINavigationController class]];

接下来，我们要使用部分 mocking。我们希望 PhotosViewController 实例的navigationController 返回 mockNavController。我们不能直接设置 navigation controller，所以我们简单地用 stub 来替换掉 PhotosViewController实例这个方法，让它返回mockNavController 就可以了。

PhotosViewController *photosViewController = [[PhotosViewController alloc] init];
id photosViewControllerMock = [OCMockObject partialMockForObject:photosViewController];
[[[photosViewControllerMock stub] andReturn:mockNavController] navigationController];

现在，任何时候对 photosViewController 调用 -navigationController 方法，都会返回 mockNavController。这是个强大的技巧，OCMock 就有这样的本领。

接下来，我们要告诉 navigation controller mock 我们调用的期望，即，一个 photo 不为 nil 的 detail view controller。

UIViewController* viewController = [OCMArg checkWithBlock:^BOOL(id obj) {
    PhotoViewController *vc = obj;
    return ([vc isKindOfClass:[PhotoViewController class]] &&
            (vc.photo != nil));
}];
[[mockNavController expect] pushViewController:viewController animated:YES];

现在，我们触发 view 加载，并且模拟一行被点击：

UIView *view = photosViewController.view;
STAssertNotNil(view, @"");
NSIndexPath* indexPath = [NSIndexPath indexPathForRow:0 inSection:0];
[photosViewController tableView:photosViewController.tableView
        didSelectRowAtIndexPath:indexPath];

最后我们验证 mocks 上期望的方法被调用过：

[mockNavController verify];
[photosViewControllerMock verify];

现在我们有了一个测试，用来测试和 navigation controller 的交互，以及正确 view controller 的创建。

又一次地，我们在示例程序中使用了便捷的方法：

- (id)autoVerifiedMockForClass:(Class)aClass;
- (id)autoVerifiedPartialMockForObject:(id)object;

于是，我们不需要记住调用-verify。

进一步探索

就像你从上面看到的那样，部分 mocking 非常强大。如果你看看 -[PhotosViewController setupTableView]方法的源码，你就会看到它是如何从 app delegate 中取出 model 对象的。

NSArray *photos = [AppDelegate sharedDelegate].store.sortedPhotos;

上面的测试依赖于这行代码。打破这种依赖的一种方式是再次使用 部分 mocking，让 app delegate 返回预定义的数据，就像这样：

id storeMock; // 假设我们已经设置过了
id appDelegate = [AppDelegate sharedDelegate]
id appDelegateMock = [OCMockObject partialMockForObject:appDelegate];
[[[appDelegateMock stub] andReturn:storeMock] store];

现在，无论何时调用[AppDelegate sharedDelegate].store，它将返回 storeMock。将这个技术使用好的话，可以确保让你的测试恰到好处地在保持简单和应对复杂之间找到平衡。

需要记住的事

部分 mock 技术将会在 mocks 的存在期间替换并保持被 mocking 的对象，并且一直有效。你可以通过提前调用[aMock stopMocking]来终于这种行为。大多数时候，你希望 部分 mock 在整个测试期间都保持有效。如果要提前终止，请确保在测试方法最后放置[aMock verify]。否则 ARC 会过早释放这个 mock，这样你就不能 -verify了，这不太可能是你想要的结果。

测试 NIB 加载

PhotoCell设置在一个 NIB 中，我们可以写一个简单的测试来检查 outlets 设置得是否正确。我们来回顾一下PhotoCell类：

@interface PhotoCell : UITableViewCell

+ (UINib *)nib;

@property (weak, nonatomic) IBOutlet UILabel* photoTitleLabel;
@property (weak, nonatomic) IBOutlet UILabel* photoDateLabel;

@end

我们的简单测试的实现看上去是这样：

@implementation PhotoCellTests

- (void)testNibLoading;
{
    UINib *nib = [PhotoCell nib];
    STAssertNotNil(nib, @"");

    NSArray *a = [nib instantiateWithOwner:nil options:@{}];
    STAssertEquals([a count], (NSUInteger) 1, @"");
    PhotoCell *cell = a[0];
    STAssertTrue([cell isMemberOfClass:[PhotoCell class]], @"");

    // 检查 outlet 是否正确设置
    STAssertNotNil(cell.photoTitleLabel, @"");
    STAssertNotNil(cell.photoDateLabel, @"");
}

@end

非常基础，但是能出色完成工作。

值得一提的是，当有发生改变时，我们需要同时更新测试以及相应的类或 nib 。这是事实。你需要考虑改变类或者 nib 文件时可能会打破原有的 outlets 连接。如果你用了 .xib 文件，你可能要注意了，这是经常发生的事。

关于 Class 和 Injection
我们已经从与 Xcode 集成得知，测试 bundle 会注入到应用程序中。省略注入的如何工作的细节（它本身是个巨大的话题），简单地说：注入是把待注入的 bundle（我们的测试 bundle）中的 Objective-C 类添加到运行的应用程序中。这很好，因为这样允许我们运行测试了。

还有一件事会很让人迷惑，那就是如果我们同时把一个类添加到应用程序和测试 bundle中。如果在上面的示例程序中，我们（不小心）把 PhotoCell 类同时添加到测试 bundle 和应用程序里的话，在测试 bundle 中调用 [PhotoCell class]会返回一个不同的指针（你应用程序中的那个类）。于是我们的测试将会失败：

STAssertTrue([cell isMemberOfClass:[PhotoCell class]], @"");

再一次声明：注入很复杂。你应该确认的是：不要把应用程序中的 .m 文件添加到测试 target 中。否则你会得到预想不到的行为。

额外的思考

如果你使用一个持续集成 (CI) 的解决方案，让你的测试启动和运行是一个好主意。详细的描述超过了本文的范围。这些脚本通过 RunUnitTests 脚本触发。还有个 TEST_AFTER_BUILD 环境变量。

另一种有趣的选择是创建单独的测试 bundle 来自动化性能测试。你可以在测试方法里做任何你想做的。定时调用一些方法并使用 STAssert 来检查它们是否在特定阈值里面是其中一种选择。

链接：https://www.jianshu.com/p/733fa8bbca95

本文介绍Java版MQTT 客户端，如何连接环信MQTT消息云快速实现消息的自收自发。

一、前提条件

1.部署Java开发环境

安装IDE。您可以使用IntelliJ IDEA或者Eclipse，本文以IntelliJ IDEA为例。
下载安装JDK。 

2.导入项目依赖

在IntelliJ IDEA中创建工程，并确认pom.xml中包含以下依赖。

    commons-codec
    commons-codec
    1.10


    org.eclipse.paho
    org.eclipse.paho.client.mqttv3
    1.2.2


    org.apache.httpcomponents
    httpclient
    4.5.2


     com.alibaba
     fastjson
     1.2.76

二、实现流程

1、获取鉴权

     为保障客户安全性需求，环信MQTT消息云服务为客户提供【token+clientID】方式实现鉴权认证，其中AppID(clientID中的关键字段)及token标识获取流程如下:

【登录console】
     欢迎您登录环信云console控制台，在此控制台中，为您提供应用列表、解决方案、DEMO体验以及常见问题等功能。
     在应用列表中，若您未在APP中开通MQTT业务，可参见APP  MQTT开通流程
     若APP已开通MQTT业务，可在应用列表中选中Appname，点击【查看】操作，进入应用详情。

【获取AppID及连接地址】 
      进入【查看】后，点击左侧菜单栏【MQTT】->【服务概览】，在下图红色方框内获取当前AppID及服务器连接地址。

【获取token】
     为实现对用户管控及接入安全性，环信云console提供用户认证功能，支持对用户账户的增、删、改、查以及为每个用户账户分配唯一token标识，获取token标识可选择以下两种形式。
  形式一：console控制台获取（管理员视角）
  * 点击左侧菜单栏【应用概览】->【用户认证】页面，点击【创建IM用户】按钮，增添新的账户信息（包  括用户名及密码）。
  * 创建成功后，在【用户ID】列表中选中账户，点击【查看token】按钮获取当前账户token信息。

  形式二：客户端代码获取（客户端视角）
  * 获取域名：点击左侧菜单栏【即时通讯】->【服务概览】页面，查看下图中token域名、org_name、app_name。

  * 拼接URL：获取token URL格式为：http:/ /token域名/org_name/app_name/token。 
  * 用户名/密码：使用【用户ID】列表中已有账户的用户名及密码，例“用户名：test/密码：test123”。

客户端获取token代码示例如下：

public static void main() 

{
    // 获取token的URL
    http://{token域名}/{org_name}/{app_name}/token
    // 获取token
    String token = "";
    // 取token
    try (final CloseableHttpClient httpClient = HttpClients.createDefault())

    {    
        final HttpPost httpPost = new HttpPost("http://{token域名}/{org_name}/{app_name}/token");
        Map params = new HashMap<>();
        params.put("grant_type", "password");
        params.put("username", "test");
        params.put("password", "test123");
        //设置请求体参数
        StringEntity entity = new StringEntity(JSONObject.toJSONString(params), Charset.forName("utf-8"));
        entity.setContentEncoding("utf-8");
        httpPost.setEntity(entity);
        //设置请求头部
        httpPost.setHeader("Content-Type", "application/json");
        //执行请求，返回请求响应
        try (final CloseableHttpResponse response = httpClient.execute(httpPost)

        {
            //请求返回状态码
            int statusCode = response.getStatusLine().getStatusCode();
            //请求成功
            if (statusCode == HttpStatus.SC_OK && statusCode <= HttpStatus.SC_TEMPORARY_REDIRECT) 

            {
                //取出响应体
                final HttpEntity entity2 = response.getEntity();
                //从响应体中解析出token
                String responseBody = EntityUtils.toString(entity2, "utf-8");
                JSONObject jsonObject = JSONObject.parseObject(responseBody);
                token = jsonObject.getString("access_token");
            } 

            else 

            {
                 //请求失败
                throw new ClientProtocolException("请求失败，响应码为：" + statusCode);
            }
        }
    } 

    catch (IOException e) 

    {
        e.printStackTrace();
    }
}

返回结果

 {
    "access_token": "YWMtN8a0oqV3EeuF0AmiqRgEh-grzF8zZk2Wp8GS3pF-orDW_F-gj3kR6os3h_oz3ROQAwMAAAF5BxhGlwBPGgAvTR8vDrdVsDPNZMQj0fFjv7EaohgZhzMHM9ncVLE30g",
    "expires_in": 5184000,
    "user": 

    {
        "uuid": "d6fc5fa0-8f79-11ea-8b37-87fa33dd1390",
        "type": "user",
        "created": 1588756404898,
        "modified": 1588756404898,
        "username": "test",
        "activated": true
    }
 }
 access_token即为要获取的token

2、初始化

      在IntelliJ IDEA工程中创建MQTT客户端，客户端初始配置包括创建clientID，topic名称，QoS质量，连接地址等信息。

import org.eclipse.paho.client.mqttv3.*;
import org.eclipse.paho.client.mqttv3.persist.MemoryPersistence;
import java.util.concurrent.ExecutorService;
import java.util.concurrent.LinkedBlockingQueue;
import java.util.concurrent.ThreadPoolExecutor;
import java.util.concurrent.TimeUnit;
import static org.eclipse.paho.client.mqttv3.MqttConnectOptions.MQTT_VERSION_3_1_1;

public class MqttDemoStarter 

{
    public static void main(String[] args) throws MqttException, InterruptedException {
        /**
        * 用户指定
        * /
        String deviceId = "xxxxx-xxxx-xxxxx-xxxxx-xxxxx";
        /**
        * 从console控制台获取
        * /
        String appId = "1NQ1E9";
        /**
         * 设置接入点，进入console控制台获取
         */
        String endpoint = "1NQ1E9.sandbox.mqtt.chat";
        /**
         * MQTT客户端ID，由业务系统分配，需要保证每个TCP连接都不一样，保证全局唯一，如果不同的客户端对象（TCP连接）使用了相同的clientId会导致之前的连接断开。
         * clientId由两部分组成，格式为DeviceID@appId，其中DeviceID由业务方自己设置，appId在console控制台创建，clientId总长度不得超过64个字符。
         */
        String clientId = deviceId + "@" + appId;

        /**
         * 需要订阅或发送消息的topic名称
         * 如果使用了没有创建或者没有被授权的Topic会导致鉴权失败，服务端会断开客户端连接。
         */
        final String myTopic = "myTopic";

        /**
         * QoS参数代表传输质量，可选0，1，2。详细信息，请参见名词解释。
         */
        final int qosLevel = 0;
        final MemoryPersistence memoryPersistence = new MemoryPersistence();

        /**
         * 客户端协议和端口。客户端使用的协议和端口必须匹配，如果是ws或者wss，使用http://；如果是mqtt或者mqtts，使用tcp://
         */
        final MqttClient mqttClient = new MqttClient("tcp://" + endpoint + ":1883", clientId, memoryPersistence);
        /**
         * 设置客户端发送超时时间，防止无限阻塞。
         */
        mqttClient.setTimeToWait(5000);

        final ExecutorService executorService = new ThreadPoolExecutor(1, 1, 0, TimeUnit.MILLISECONDS,
                new LinkedBlockingQueue<>());
}

3、连接服务器

    配置连接密码、cleansession标志、心跳间隔、超时时间等信息，调用connect（）函数连接至环信MQTT消息云。

MqttConnectOptions mqttConnectOptions = new MqttConnectOptions();
        /**
         * 用户名，在console中注册
         */
        mqttConnectOptions.setUserName("test");
        /**
         * 用户密码为第一步中申请的token
         */
        mqttConnectOptions.setPassword(token.toCharArray());
        mqttConnectOptions.setCleanSession(true);
        mqttConnectOptions.setKeepAliveInterval(90);
        mqttConnectOptions.setAutomaticReconnect(true);
        mqttConnectOptions.setMqttVersion(MQTT_VERSION_3_1_1);
        mqttConnectOptions.setConnectionTimeout(5000);
        mqttClient.connect(mqttConnectOptions);
        //暂停1秒钟，等待连接订阅完成
        Thread.sleep(1000);

4、订阅【subscribe】

【订阅主题】

    当客户端成功连接环信MQTT消息云后，需尽快向服务器发送订阅主题消息。

mqttClient.setCallback(new MqttCallbackExtended() {
        /**
        * 连接完成回调方法
        * @param b
        * @param s
        */
        @Override
        public void connectComplete(boolean b, String s) {
            /**
            * 客户端连接成功后就需要尽快订阅需要的Topic。
            */
            System.out.println("connect success");
            executorService.submit(() -> {
                try {
                    final String[] topicFilter = {myTopic};
                    final int[] qos = {qosLevel};
                    mqttClient.subscribe(topicFilter, qos);
                } catch (Exception e) {
                    e.printStackTrace();
                }
            });
        }
});

【取消订阅】

mqttClient.unsubscribe(new String[]{myTopic});

【接收消息】

    配置接收消息回调方法，从环信MQTT消息云接收订阅消息。

mqttClient.setCallback(new MqttCallbackExtended() {
        /**
        * 接收消息回调方法
        * @param s
        * @param mqttMessage
        */
        @Override
        public void messageArrived(String s, MqttMessage mqttMessage) {
            System.out.println("receive msg from topic " + s + " , body is " + new String(mqttMessage.getPayload()));
        }
});

5、发布【publish】

    配置发送消息回调方法，向环信MQTT消息云中指定topic发送消息。

for (int i = 0; i < 10; i++) {
        /**
        * 构建一个Mqtt消息
        */
        MqttMessage message = new MqttMessage("hello world pub sub msg".getBytes());
        //设置传输质量
        message.setQos(qosLevel);
        /**
        * 发送普通消息时，Topic必须和接收方订阅的Topic一致，或者符合通配符匹配规则。
        */
        mqttClient.publish(myTopic, message);
}

6、结果验证

connect success
send msg succeed topic is : myTopic
send msg succeed topic is : myTopic
send msg succeed topic is : myTopic
send msg succeed topic is : myTopic
send msg succeed topic is : myTopic
send msg succeed topic is : myTopic
send msg succeed topic is : myTopic
send msg succeed topic is : myTopic
send msg succeed topic is : myTopic
send msg succeed topic is : myTopic
receive msg from topic myTopic , body is hello world pub sub msg
receive msg from topic myTopic , body is hello world pub sub msg
receive msg from topic myTopic , body is hello world pub sub msg
receive msg from topic myTopic , body is hello world pub sub msg
receive msg from topic myTopic , body is hello world pub sub msg
receive msg from topic myTopic , body is hello world pub sub msg
receive msg from topic myTopic , body is hello world pub sub msg
receive msg from topic myTopic , body is hello world pub sub msg
receive msg from topic myTopic , body is hello world pub sub msg
receive msg from topic myTopic , body is hello world pub sub msg

三、更多信息

  * 完整demo示例，请参见demo下载。

或直接下载：MQTTChatDemo- Java.zip

  * 目前MQTT客户端支持多种语言，请参见 SDK下载。
  * 如果您在使用环信MQTT消息云服务中，有任何疑问和建议，欢迎您联系我们。

ASIHTTPRequest 是一个围绕 CFNetwork API的易于使用的包装器，它使与 Web 服务器通信的一些更乏味的方面变得更容易。它是用 Objective-C 编写的，适用于 Mac OS X 和 iPhone 应用程序。

它适用于执行基本的HTTP请求并与基于REST的服务（GET / POST / PUT / DELETE）交互。包含的 ASIFormDataRequest 子类使得使用 multipart/form-data提交POST数据和文件变得容易。

它提供：

• 一个简单的界面，用于向网络服务器提交数据和从网络服务器获取数据
• 将数据下载到内存或直接下载到磁盘上的文件
• 在本地驱动器上提交文件作为POST数据的一部分，与HTML文件输入机制兼容
• 将请求正文直接从磁盘传输到服务器，以节省内存
• 恢复部分下载
• 轻松访问请求和响应HTTP标头
• 进度委托（NSProgressIndicators 和 UIProgressViews）显示有关下载和上传进度的信息
• 操作队列上传下载进度指示器的自动魔法管理
• 基本、摘要 + NTLM身份验证支持，凭据在会话期间自动重复使用，并且可以存储在钥匙串中以备日后使用。
• 饼干支持
• [新]当您的应用程序移至后台时，请求可以继续运行（iOS 4+）
• GZIP支持响应数据和请求正文
• 包含的 ASIDownloadCache 类允许请求透明地缓存响应，并且即使在没有可用网络的情况下也允许对缓存数据的请求成功
• [新] ASIWebPageRequest – 下载完整的网页，包括图像和样式表等外部资源。即使没有网络连接，任何大小的页面都可以无限期地缓存，并显示在 UIWebview/WebView 中。
• 易于使用的 Amazon S3 支持 – 无需自己动手签署请求！
• 完全支持 Rackspace 云文件
• [新]客户端证书支持
• 支持手动和自动检测代理、验证代理和PAC文件自动配置。内置的登录对话框让您的 iPhone 应用程序可以透明地使用身份验证代理，无需任何额外工作。
• 带宽限制支持
• 支持持久连接
• 支持同步和异步请求
• 通过委托或 [ NEW ] 块获取有关请求状态更改的通知（Mac OS X 10.6、iOS 4 及更高版本）
• 带有广泛的单元测试

ASIHTTPRequest 兼容 Mac OS 10.5 或更高版本，以及 iOS 3.0 或更高版本。

创建同步请求

使用 ASIHTTPRequest 的最简单方法。发送startSynchronous 消息将在同一线程中执行请求，并在完成（成功或失败）时返回控制权。

通过检查error属性来检查问题。

要以字符串形式获取响应，请调用responseString方法。不要将它用于二进制数据 - 使用responseData获取 NSData 对象，或者，对于较大的文件，将您的请求设置为使用downloadDestinationPath属性下载到文件。

- (IBAction)grabURL:(id)sender

{

  NSURL *url = [NSURL URLWithString:@"http://allseeing-i.com"];

  ASIHTTPRequest *request = [ASIHTTPRequest requestWithURL:url];

  [request startSynchronous];

  NSError *error = [request error];

  if (!error) {

    NSString *response = [request responseString];

  }

}

与前面的示例执行相同的操作，但请求在后台运行。

- (IBAction)grabURLInBackground:(id)sender

{

   NSURL *url = [NSURL URLWithString:@"http://allseeing-i.com"];

   ASIHTTPRequest *request = [ASIHTTPRequest requestWithURL:url];

   [request setDelegate:self];

   [request startAsynchronous];

}

 

- (void)requestFinished:(ASIHTTPRequest *)request

{

   // Use when fetching text data

   NSString *responseString = [request responseString];

 

   // Use when fetching binary data

   NSData *responseData = [request responseData];

}

 

- (void)requestFailed:(ASIHTTPRequest *)request

{

   NSError *error = [request error];

}

请注意，我们设置了请求的委托属性，以便我们可以在请求完成或失败时收到通知。

这是创建异步请求的最简单方法，它将在后台运行在全局 NSOperationQueue 中。对于更复杂的操作（例如跟踪多个请求的进度），您可能希望创建自己的队列，这就是我们接下来将介绍的内容。

使用块

从 v1.8 开始，我们可以在支持块的平台上使用块来做同样的事情：

- (IBAction)grabURLInBackground:(id)sender

{

   NSURL *url = [NSURL URLWithString:@"http://allseeing-i.com"];

   __block ASIHTTPRequest *request = [ASIHTTPRequest requestWithURL:url];

   [request setCompletionBlock:^{

      // Use when fetching text data

      NSString *responseString = [request responseString];

 

      // Use when fetching binary data

      NSData *responseData = [request responseData];

   }];

   [request setFailedBlock:^{

      NSError *error = [request error];

   }];

   [request startAsynchronous];

}

请注意在我们声明请求时使用__block限定符，这很重要！它告诉块不要保留请求，这对于防止保留循环很重要，因为请求将始终保留块。

使用队列

这个例子再次做同样的事情，但我们为我们的请求创建了一个 NSOperationQueue。

使用您自己创建的 NSOperationQueue（或 ASINetworkQueue，见下文）可以让您更好地控制异步请求。使用队列时，只能同时运行一定数量的请求。如果您添加的请求多于队列的maxConcurrentOperationCount属性，则请求将在开始之前等待其他人完成。

- (IBAction)grabURLInTheBackground:(id)sender

{

   if (![self queue]) {

      [self setQueue:[[[NSOperationQueue alloc] init] autorelease]];

   }

 

   NSURL *url = [NSURL URLWithString:@"http://allseeing-i.com"];

   ASIHTTPRequest *request = [ASIHTTPRequest requestWithURL:url];

   [request setDelegate:self];

   [request setDidFinishSelector:@selector(requestDone:)];

   [request setDidFailSelector:@selector(requestWentWrong:)];

   [[self queue] addOperation:request]; //queue is an NSOperationQueue

}

 

- (void)requestDone:(ASIHTTPRequest *)request

{

   NSString *response = [request responseString];

}

 

- (void)requestWentWrong:(ASIHTTPRequest *)request

{

   NSError *error = [request error];

}

demo及常见问题:https://github.com/paytronix/ASIHTTPRequest

源码下载:ASIHTTPRequest-master.zip

FlatUIKit

FlatUIKit 是我们在为 iPhone构建Grouper 时创建的具有“Flat UI”美学风格的 iOS 组件集合。它的设计灵感来自于Flat UI和Kyle Miller。样式是通过替换现有 UIKit 组件的类别来实现的，因此将其集成到您的项目中非常简单。

安装

pod 'FlatUIKit'

myButton.buttonColor = [UIColor turquoiseColor ];

myButton.shadowColor = [UIColor greenSeaColor ];

myButton.shadowHeight = 3。0f ;

myButton.cornerRadius = 6。0f ;

myButton.titleLabel.font = [UIFont boldFlatFontOfSize: 16 ];

[myButton setTitleColor: [UIColor cloudColor ] forState: UIControlStateNormal];

[myButton setTitleColor: [UIColor cloudColor ] forState: UIControlStateHighlighted];

myTextField.font = [UIFont flatFontOfSize: 16 ];

myTextField.backgroundColor = [UIColor clearColor ];

myTextField.edgeInsets = UIEdgeInsetsMake( 4 . 0f , 15 . 0f , 4 . 0f , 15 . 0f );

myTextField.textFieldColor = [UIColor whiteColor ];

myTextField.borderColor = [UIColor turquoiseColor ];

myTextField.borderWidth = 2。0f ;

myTextField.cornerRadius = 3。0f ;

FUISegmentedControl 是 UISegmentedControl 的一个嵌入式子类，它公开了附加属性 selectedColor、deselectedColor、selectedFont、deselectedFont、selectedFontColor、deselectedFontColor、dividerColor 和 cornerRadius。请注意，如果您设置了其中任何一个，建议您设置所有这些。

mySegmentedControl.selectedFont = [UIFont boldFlatFontOfSize: 16 ];

mySegmentedControl.selectedFontColor = [UIColor cloudColor ];

mySegmentedControl.deselectedFont = [UIFont flatFontOfSize: 16 ];

mySegmentedControl.deselectedFontColor = [UIColor cloudColor ];

mySegmentedControl.selectedColor = [UIColor amethystColor ];

mySegmentedControl.deselectedColor = [UIColor silverColor ];

mySegmentedControl.dividerColor = [的UIColor midnightBlueColor ];

mySegmentedControl.cornerRadius = 5.0 ;

mySwitch.onColor = [UIColor turquoiseColor ];

mySwitch.offColor = [UIColor cloudColor ];

mySwitch.onBackgroundColor = [的UIColor midnightBlueColor ];

mySwitch.offBackgroundColor = [UIColor silverColor ];

mySwitch.offLabel.font = [UIFont boldFlatFontOfSize: 14 ];

mySwitch.onLabel.font = [UIFont boldFlatFontOfSize: 14 ];

FUIAlertView *alertView = [[FUIAlertView alloc ] initWithTitle: @" Hello "

                                                       message: @" This is an alert view "

                                                      delegate: nil  cancelButtonTitle: @" Dismiss "

                                             otherButtonTitles: @" Do Something " , nil ];

alertView.titleLabel.textColor = [UIColor cloudColor ];

alertView.titleLabel.font = [UIFont boldFlatFontOfSize: 16 ];

alertView.messageLabel.textColor = [UIColor cloudColor ];

alertView.messageLabel.font = [UIFont flatFontOfSize: 14 ];

alertView.backgroundOverlay.backgroundColor = [[UIColor cloudColor ] colorWithAlphaComponent: 0.8 ];

alertView.alertContainer.backgroundColor = [的UIColor midnightBlueColor ];

alertView.defaultButtonColor = [UIColor cloudColor ];

alertView.defaultButtonShadowColor = [UIColor asbestosColor ];

alertView.defaultButtonFont = [UIFont boldFlatFontOfSize: 16 ];

alertView.defaultButtonTitleColor = [UIColor asbestosColor ];

[mySlider configureFlatSliderWithTrackColor: [UIColor silverColor ]

                               progressColor: [UIColor alizarinColor ]

                                  thumbColor: [UIColor pomegranateColor ]];

[myProgressView configureFlatProgressViewWithTrackColor: [UIColor silverColor ]

                               progressColor: [UIColor alizarinColor ]];



[myStepper configureFlatStepperWithColor： [的UIColor wisteriaColor ]

                         highlightedColor： [的UIColor wisteriaColor ]

                            disabledColor： [的UIColor amethystColor ]

                                iconColor通过： [的UIColor cloudsColor ]];

[UIBarButtonItem configureFlatButtonsWithColor: [UIColor peterRiverColor ]

                               highlightColor: [UIColor belizeHoleColor ]

                                   cornerRadius: 3 ];

[UIBarButtonItem configureFlatButtonsWithColor: [UIColor peterRiverColor ]

                               highlightColor: [UIColor belizeHoleColor ]

                                   cornerRadius: 3 

                               whenContainedIn: [YourViewController class ]];

UITableViewCell *cell = ...;

[cell configureFlatCellWithColor: [UIColor greenSeaColor ]

                    selectedColor: [UIColor cloudColor ]

                  roundingCorners: corners];



cell.cornerRadius = 5。0f ; //可选

cell.separatorHeight = 2 . 0f ; //可选

Mantle 使为您的 Cocoa 或 Cocoa Touch 应用程序编写简单的模型层变得容易

Let's use the GitHub API for demonstration~!

typedef enum : NSUInteger {

    GHIssueStateOpen,

    GHIssueStateClosed

} GHIssueState;



@interface GHIssue : NSObject <NSCoding, NSCopying>



@property (nonatomic, copy, readonly) NSURL *URL;

@property (nonatomic, copy, readonly) NSURL *HTMLURL;

@property (nonatomic, copy, readonly) NSNumber *number;

@property (nonatomic, assign, readonly) GHIssueState state;

@property (nonatomic, copy, readonly) NSString *reporterLogin;

@property (nonatomic, copy, readonly) NSDate *updatedAt;

@property (nonatomic, strong, readonly) GHUser *assignee;

@property (nonatomic, copy, readonly) NSDate *retrievedAt;



@property (nonatomic, copy) NSString *title;

@property (nonatomic, copy) NSString *body;



- (id)initWithDictionary:(NSDictionary *)dictionary;



@end

typedef enum : NSUInteger {

    GHIssueStateOpen,

    GHIssueStateClosed

} GHIssueState;



@interface GHIssue : NSObject <NSCoding, NSCopying>



@property (nonatomic, copy, readonly) NSURL *URL;

@property (nonatomic, copy, readonly) NSURL *HTMLURL;

@property (nonatomic, copy, readonly) NSNumber *number;

@property (nonatomic, assign, readonly) GHIssueState state;

@property (nonatomic, copy, readonly) NSString *reporterLogin;

@property (nonatomic, copy, readonly) NSDate *updatedAt;

@property (nonatomic, strong, readonly) GHUser *assignee;

@property (nonatomic, copy, readonly) NSDate *retrievedAt;



@property (nonatomic, copy) NSString *title;

@property (nonatomic, copy) NSString *body;



- (id)initWithDictionary:(NSDictionary *)dictionary;



@end

@implementation GHIssue



+ (NSDateFormatter *)dateFormatter {

    NSDateFormatter *dateFormatter = [[NSDateFormatter alloc] init];

    dateFormatter.locale = [[NSLocale alloc] initWithLocaleIdentifier:@"en_US_POSIX"];

    dateFormatter.dateFormat = @"yyyy-MM-dd'T'HH:mm:ss'Z'";

    return dateFormatter;

}



- (id)initWithDictionary:(NSDictionary *)dictionary {

    self = [self init];

    if (self == nil) return nil;



    _URL = [NSURL URLWithString:dictionary[@"url"]];

    _HTMLURL = [NSURL URLWithString:dictionary[@"html_url"]];

    _number = dictionary[@"number"];



    if ([dictionary[@"state"] isEqualToString:@"open"]) {

        _state = GHIssueStateOpen;

    } else if ([dictionary[@"state"] isEqualToString:@"closed"]) {

        _state = GHIssueStateClosed;

    }



    _title = [dictionary[@"title"] copy];

    _retrievedAt = [NSDate date];

    _body = [dictionary[@"body"] copy];

    _reporterLogin = [dictionary[@"user"][@"login"] copy];

    _assignee = [[GHUser alloc] initWithDictionary:dictionary[@"assignee"]];



    _updatedAt = [self.class.dateFormatter dateFromString:dictionary[@"updated_at"]];



    return self;

}



- (id)initWithCoder:(NSCoder *)coder {

    self = [self init];

    if (self == nil) return nil;



    _URL = [coder decodeObjectForKey:@"URL"];

    _HTMLURL = [coder decodeObjectForKey:@"HTMLURL"];

    _number = [coder decodeObjectForKey:@"number"];

    _state = [coder decodeUnsignedIntegerForKey:@"state"];

    _title = [coder decodeObjectForKey:@"title"];

    _retrievedAt = [NSDate date];

    _body = [coder decodeObjectForKey:@"body"];

    _reporterLogin = [coder decodeObjectForKey:@"reporterLogin"];

    _assignee = [coder decodeObjectForKey:@"assignee"];

    _updatedAt = [coder decodeObjectForKey:@"updatedAt"];



    return self;

}



- (void)encodeWithCoder:(NSCoder *)coder {

    if (self.URL != nil) [coder encodeObject:self.URL forKey:@"URL"];

    if (self.HTMLURL != nil) [coder encodeObject:self.HTMLURL forKey:@"HTMLURL"];

    if (self.number != nil) [coder encodeObject:self.number forKey:@"number"];

    if (self.title != nil) [coder encodeObject:self.title forKey:@"title"];

    if (self.body != nil) [coder encodeObject:self.body forKey:@"body"];

    if (self.reporterLogin != nil) [coder encodeObject:self.reporterLogin forKey:@"reporterLogin"];

    if (self.assignee != nil) [coder encodeObject:self.assignee forKey:@"assignee"];

    if (self.updatedAt != nil) [coder encodeObject:self.updatedAt forKey:@"updatedAt"];



    [coder encodeUnsignedInteger:self.state forKey:@"state"];

}



- (id)copyWithZone:(NSZone *)zone {

    GHIssue *issue = [[self.class allocWithZone:zone] init];

    issue->_URL = self.URL;

    issue->_HTMLURL = self.HTMLURL;

    issue->_number = self.number;

    issue->_state = self.state;

    issue->_reporterLogin = self.reporterLogin;

    issue->_assignee = self.assignee;

    issue->_updatedAt = self.updatedAt;



    issue.title = self.title;

    issue->_retrievedAt = [NSDate date];

    issue.body = self.body;



    return issue;

}



- (NSUInteger)hash {

    return self.number.hash;

}



- (BOOL)isEqual:(GHIssue *)issue {

    if (![issue isKindOfClass:GHIssue.class]) return NO;



    return [self.number isEqual:issue.number] && [self.title isEqual:issue.title] && [self.body isEqual:issue.body];

}



@end

哇，对于这么简单的事情来说，这是很多样板！而且，即便如此，这个例子也没有解决一些问题：

• 无法GHIssue使用来自服务器的新数据更新 a 。
• 没有办法将 a 变GHIssue 回JSON。
• GHIssueState不应按原样编码。如果将来枚举更改，现有存档可能会中断。
• 如果未来的界面发生GHIssue变化，现有的档案可能会中断。

为什么不使用核心数据？

Core Data 很好地解决了某些问题。如果您需要对数据执行复杂的查询，处理具有大量关系的巨大对象图，或支持撤消和重做，Core Data 非常适合。

然而，它确实有几个痛点：

• 仍然有很多样板。托管对象减少了上面看到的一些样板，但 Core Data 有很多自己的样板。正确设置 Core Data 堆栈（带有持久存储和持久存储协调器）并执行提取可能需要多行代码。
• 很难做对。即使是有经验的开发人员在使用 Core Data 时也可能会犯错误，而且该框架是不可原谅的。

如果您只是想访问一些 JSON 对象，那么 Core Data 可能会做大量工作，但收获甚微。

尽管如此，如果您已经在应用程序中使用或想要使用 Core Data，Mantle 仍然可以作为 API 和托管模型对象之间的方便转换层。

MTL模型

输入 MTLModel。这GHIssue看起来像继承自MTLModel：

typedef enum : NSUInteger {

    GHIssueStateOpen,

    GHIssueStateClosed

} GHIssueState;



@interface GHIssue : MTLModel 



@property (nonatomic, copy, readonly) NSURL *URL;

@property (nonatomic, copy, readonly) NSURL *HTMLURL;

@property (nonatomic, copy, readonly) NSNumber *number;

@property (nonatomic, assign, readonly) GHIssueState state;

@property (nonatomic, copy, readonly) NSString *reporterLogin;

@property (nonatomic, strong, readonly) GHUser *assignee;

@property (nonatomic, copy, readonly) NSDate *updatedAt;



@property (nonatomic, copy) NSString *title;

@property (nonatomic, copy) NSString *body;



@property (nonatomic, copy, readonly) NSDate *retrievedAt;



@end

@implementation GHIssue



+ (NSDateFormatter *)dateFormatter {

    NSDateFormatter *dateFormatter = [[NSDateFormatter alloc] init];

    dateFormatter.locale = [[NSLocale alloc] initWithLocaleIdentifier:@"en_US_POSIX"];

    dateFormatter.dateFormat = @"yyyy-MM-dd'T'HH:mm:ss'Z'";

    return dateFormatter;

}



+ (NSDictionary *)JSONKeyPathsByPropertyKey {

    return @{

        @"URL": @"url",

        @"HTMLURL": @"html_url",

        @"number": @"number",

        @"state": @"state",

        @"reporterLogin": @"user.login",

        @"assignee": @"assignee",

        @"updatedAt": @"updated_at"

    };

}



+ (NSValueTransformer *)URLJSONTransformer {

    return [NSValueTransformer valueTransformerForName:MTLURLValueTransformerName];

}



+ (NSValueTransformer *)HTMLURLJSONTransformer {

    return [NSValueTransformer valueTransformerForName:MTLURLValueTransformerName];

}



+ (NSValueTransformer *)stateJSONTransformer {

    return [NSValueTransformer mtl_valueMappingTransformerWithDictionary:@{

        @"open": @(GHIssueStateOpen),

        @"closed": @(GHIssueStateClosed)

    }];

}



+ (NSValueTransformer *)assigneeJSONTransformer {

    return [MTLJSONAdapter dictionaryTransformerWithModelClass:GHUser.class];

}



+ (NSValueTransformer *)updatedAtJSONTransformer {

    return [MTLValueTransformer transformerUsingForwardBlock:^id(NSString *dateString, BOOL *success, NSError *__autoreleasing *error) {

        return [self.dateFormatter dateFromString:dateString];

    } reverseBlock:^id(NSDate *date, BOOL *success, NSError *__autoreleasing *error) {

        return [self.dateFormatter stringFromDate:date];

    }];

}



- (instancetype)initWithDictionary:(NSDictionary *)dictionaryValue error:(NSError **)error {

    self = [super initWithDictionary:dictionaryValue error:error];

    if (self == nil) return nil;



    // Store a value that needs to be determined locally upon initialization.

    _retrievedAt = [NSDate date];



    return self;

}



@end

值得注意的是，从这个版本是缺席的实现， ，-isEqual:，和-hash。通过检查@property 您在子类中的声明，MTLModel可以为所有这些方法提供默认实现。

原始示例的问题也都被修复了：

无法GHIssue使用来自服务器的新数据更新 a 。

MTLModel有一个可扩展的-mergeValuesForKeysFromModel:方法，可以很容易地指定应该如何集成新的模型数据。

没有办法将 a 变GHIssue 回JSON。

这是可逆变压器真正派上用场的地方。+[MTLJSONAdapter JSONDictionaryFromModel:error:]可以将任何符合 的模型对象转换 回 JSON 字典。+[MTLJSONAdapter JSONArrayFromModels:error:]是相同的，但将模型对象数组转换为字典的 JSON 数组。

如果未来的界面发生GHIssue变化，现有的档案可能会中断。

MTLModel自动保存用于存档的模型对象的版本。取消归档时，-decodeValueForKey:withCoder:modelVersion:如果被覆盖，将被调用，为您提供一个方便的挂钩来升级旧数据。

Mantle 不会自动为您保留对象。但是，MTLModel 确实符合，因此可以使用 将模型对象存档到磁盘 NSKeyedArchiver。

如果你需要更强大的东西，或者想要避免将整个模型一次保存在内存中，Core Data 可能是更好的选择。

Carthage

github "Mantle/Mantle"

CocoaPods

target 'MyAppOrFramework' do

  pod 'Mantle'

end

demo下载及常见问题:https://github.com/Mantle/Mantle

源码:Mantle-master.zip

BaseNotification

获取此框架 

allprojects {
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}

dependencies {
    implementation 'com.github.Dboy233:BaseNotification:2.0'
}

如何使用此封装框架？

1.自定义你的Notification继承BaseNotification

public abstract class ChatChannelNotify<ChatData> extends BaseNotification<ChatData> {

   
    public ChatChannelNotify(@NotNull ChatData mData) {
        super(mData);
        //使用add*函数添加对应自定义的布局 然后使用get*
        addContentRemoteViews(R.layout.notify_comm_chat_layout);
    }
	/**
	*渠道名字
	*/
    @NotNull
    @Override
    public String getChannelName() {
        return NotificationConfig.CHANNEL_ID_CHAT;
    }
	/**
	 *渠道id
	 */
    @NotNull
    @Override
    public String getChannelId() {
        return NotificationConfig.CHANNEL_ID_CHAT;
    }

    @Override
    @RequiresApi(api = Build.VERSION_CODES.O)
    public void configureChannel(@NotNull NotificationChannel notificationChannel) {
 		//配置渠道信息。如果没有这个渠道会创建这个渠道，如果有了，这个函数是不会被调用的
       notificationChannel.setLockscreenVisibility(NotificationCompat.VISIBILITY_PUBLIC);
        notificationChannel.setImportance(NotificationManager.IMPORTANCE_HIGH);
    }


    @Override
    public void configureNotify(@NotNull NotificationCompat.Builder mBuilder) {
    		//配置你的通知属性
           mBuilder.setShowWhen(true)
                .setSmallIcon(getData().getSmallIcon())
                .setContentTitle(getData().getContentTitle())
                .setContentText(getData().getContentText())
                .setTicker(getData().getContentTitle())
                .setContentInfo(getData().getContentText())
                .setAutoCancel(true)
                .setSubText(getData().getContentText())
                .setVisibility(NotificationCompat.VISIBILITY_PRIVATE)
                .setPriority(NotificationCompat.PRIORITY_MAX)
                .setGroup("chat");
    }
    
    /**
     *如果你在构造函数使用了add**的函数添加自定义布局 在这里配置你布局展示的数据
     *使用**2结尾的函数可链式调用 点击事件做了单独封装
     */
     @Override
 public void convert(@NotNull BaseRemoteViews mBaseRemoteViews, @NotNull ChatData data) {
     ContentRemote contentRemote = mBaseRemoteViews.getContentRemote();
   if (contentRemote != null) {
       contentRemote
            .setImageViewResource2(R.id.notify_chat_head_img, data.getIcon())
            .setTextViewText2(R.id.notify_chat_title, data.getContentTitle())
            .setTextViewText2(R.id.notify_chat_subtitle, data.getContentText())
            .setOnClickPendingIntent2(getNotificationId(), R.id.notify_chat_layout);
        }
        
  }
	/**
	 *设置你的通知id
	 */
     @Override
    public int getNotificationId() {
        return NotificationConfig.NOTIFICATION_ID;
    }

}

2.实例化你的通知并展示

ChatChannelNotify chat=new ChatChannelNotify(new Chat())
chat.show()//显示我们的通知
//更新内容使用 chat.show(new Chat())
//取消通知 chat.cancel()

3.设置点击事件

class ChatActivity : AppCompatActivity(), PendingIntentListener {
 
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        //设置点击事件
        NotificationControl.addPendingIntentListener(this)
    }
    
    /**
     *通知点击事件回调
     *notifId通知的id
     *ViewId点击的viewId
     */
   override fun onClick(notifyId: Int, viewId: Int) {
        Toast.makeText(this,
            "点击事件： notifyId:" + notifyId + "  ViewId:" + viewId, Toast.LENGTH_LONG)
            .show()
    }
    
     override fun onDestroy() {
        super.onDestroy()
        //销毁点击事件
        NotificationControl.removePendingIntentListener(this)
    }
}

原文链接:https://github.com/Dboy233/BaseNotification

代码下载:BaseNotification-master.zip

APP自动增量更新

抽取的Android自动更新库,目的是几行代码引入更新功能,含服务端代码,欢迎Star，欢迎Fork，谢谢～

目录

• 功能介绍
• 流程图
• 效果图与示例apk
• 如何引入
• 更新清单文件
• 简单使用
• 详细说明
• 差分包生成(服务端)
• 依赖
• License

功能介绍

•  支持全量更新apk,直接升级到最新版本
•  支持增量更新,只下载补丁包升级
•  设置仅在wifi环境下更新
•  支持外部注入网络框架(库默认使用okhttp)
•  支持前台或后台自动更新
•  支持基于版本的强制更新
•  支持对外定制更新提示和更新进度界面
•  含发布功能后台服务端github (Node.js实现)

流程图

效果图与示例apk

如何引入

Gradle引入

step 1

Add the JitPack repository to your build file

allprojects {
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}
dependencies {
    implementation 'com.github.itlwy:AppSmartUpdate:v1.0.7'
}

Step 2

Add the dependency

更新清单文件

该清单放置在静态服务器以供App访问，主要用于判断最新的版本，及要更新的版本资源信息等(示例见仓库根目录下的resources目录或直接访问后台代码 github)，清单由服务端程序发布apk时生成，详见后台示例:github

{
  "minVersion": 100, // app最低支持的版本代码(包含),低于此数值的app将强制更新
  "minAllowPatchVersion": 100, // 最低支持的差分版本(包含),低于此数值的app将采取全量更新,否则采用差量
  "newVersion": 101, // 当前最新版本代码
  "tip": "test update",	// 更新提示
  "size": 1956631,	// 最新apk文件大小
  "apkURL": "https://raw.githubusercontent.com/itlwy/AppSmartUpdate/master/resources/app/smart-update.apk", // 最新apk 绝对url地址，也可用相对地址，如下方的"patchURL"字段
  "hash": "ea97c8efa490a2eaf7d10b37e63dab0e", // 最新apk文件的md5值
  "patchInfo": {  // 差分包信息
    "v100": { // v100表示-版本代码100的apk需要下载的差分包
      "patchURL": "v100/100to101.patch", //差分包地址，相对此UpdateManifest.json文件的地址,也可用绝对地址
      "tip": "101 version", // 提示
      "hash": "ea97c8efa490a2eaf7d10b37e63dab0e", // 合成后apk(即版本代码101)的文件md5值
      "size": 1114810 // 差分包大小
    }
  }
}

简单使用

1.初始化

public class MyApplication extends Application {

    @Override
    public void onCreate() {
        super.onCreate();
        //推荐在Application中初始化
        Config config = new Config.Builder()
                .isDebug(true)
                .build(this);
        UpdateManager.getInstance().init(config);
    }
}

2.调用

public class MainActivity extends AppCompatActivity implements View.OnClickListener {
 private Button mUpdateBtn;
    private String manifestJsonUrl = "https://raw.githubusercontent.com/itlwy/AppSmartUpdate/master/resources/UpdateManifest.json";
    private IUpdateCallback mCallback;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        mUpdateBtn = (Button) findViewById(R.id.update_btn);
        mUpdateBtn.setOnClickListener(this);

    }

    @Override
    public void onClick(View v) {
        switch (v.getId()) {
            case R.id.update_btn:
                UpdateManager.getInstance().update(this, manifestJsonUrl, null);
                break;

        }
    }
}