什么是SDK？好的SDK有什么特点？如何做好SDK？
什么是SDK？SDK，全称为Software Development Kit，码分是码分专为软件开发者设计的一组工具和资源，它为特定软件平台或服务的码分开发提供了必要的框架和支持。它主要面向B端客户，码分对开发者的码分微赞 源码技能和效率有着极高的要求。一款优秀的码分SDK应具备以下特点：
简洁易用: 它的接口设计直观，只需一行简洁的码分代码就能轻松初始化，降低了集成和使用门槛。码分
稳定高效: SDK的码分API稳定可靠，业务逻辑设计稳健，码分运行时性能优越，码分版本更新平滑，码分确保应用的码分长期稳定运行。
内存优化: 优秀的码分SDK注重内存管理，尽可能减少内存抖动，有效控制电量消耗，为开发者创造更高效的应用环境。
如何打造优质SDK?设计良好的SDK需要遵循模块化原则，如单一职责原则，确保每个方法只负责单一功能，避免过度复杂，一般控制在行以内，实现模块间的独立性和复用性。提供小而美的接口，避免大而全的设计，让用户能够快速理解和使用。
在访问权限控制上，尽量使用私有方法和静态方法保持线程安全，保护继承关系，确保代码的安全性，避免外部不必要的小偷 源码干扰。 避免的设计陷阱：- 避免长参数列表，保持接口简洁；
- 不要返回null，明确异常处理机制，增强代码的健壮性；
- 尽量减少引入不必要的第三方库，遵循最小可用性和最少依赖原则，考虑到兼容性和代码侵入性的问题。
交付与支持：- SDK的打包需要精心，推荐使用aar格式，提供源码以便开发者进行定制，同时注意混淆内部实现，保护知识产权。
- 文档是灵魂，提供详尽的接入文档，包括清晰的使用步骤和常见问题解决方案，帮助开发者快速上手。
总的来说，一个优秀的SDK不仅需要技术上的精湛，更需注重用户体验和开发者体验，为开发者提供无缝的开发环境，推动软件生态的繁荣。一文带你读懂SDK测试
SDK，全称：software development kit，软件开发工具包。
软件开发工具包通常是软件工程师为特定软件包、软件框架、硬件平台、操作系统等建立应用软件时使用的开发工具集合。
软件开发工具广义上指辅助开发某一类软件的相关文档、范例和工具的集合。
软件开发工具包是一些被软件工程师用于为特定软件包、软件框架、EA 源码硬件平台、操作系统等创建应用软件的开发工具集合，通常SDK是用于开发Windows平台下应用程序的SDK。它可以简单地为某个程序设计语言提供应用程序接口API的一些文件，也可能包括能与某种嵌入式系统通讯的复杂硬件。一般工具包括用于调试和其他用途的实用工具。SDK还经常包括示例代码、支持性的技术注解或者其他的为基本参考资料澄清疑点的支持文档。
客户端SDK是为第三方开发者提供的软件开发工具包，包括SDK接口、接入文档以及demo等。
可以在任何第三方应用中集成，使用方便。
SDK和API的区别有以下几点：
1、组成不同：
SDK软件开发工具包括广义上指辅助开发某一类软件的相关文档、范例和工具的集合。API（应用程序接口）是一些预先定义的函数，或指软件系统不同组成部分衔接的约定。
2、用途不同：
API目的是提供应用程序与开发人员基于某软件或硬件得以访问一组例程的能力，而又无需访问源码，或理解内部工作机制的细节。软件开发工具包通常是软件工程师为特定软件包、软件框架、硬件平台、操作系统等建立应用软件时的开发工具。
3、内容不同：
为了使用API函数，需要相应的.h和.lib文件，而SDK正是提供了一整套开发Windows应用程序所需的相关文件、范例和工具的软件 网站源码“工具包”。SDK包含了使用API的必需资料，所以也常把仅使用API来编写Windows应用程序的开发方式叫作“SDK编程”。
客户端SDK测试，就是对提供给开发者工具包里面的内容进行测试，因此测试的主要内容有：
1） SDK接口和文档
SDK接口是测试的主要对象，也是核心内容。
2） SDK日志打印
对开发者来说，SDK接口里面的具体实现是透明的，当上层调用时遇到问题，可以依赖SDK打印的日志来定位分析。所以SDK日志是否完备，有助于问题的顺利解决，对应用开发者、测试人员、SDK提供方来说都很重要。
3） 程序示例：demo
demo是SDK提供方用来展示如何调用接口实现具体的功能，也可以作为开发者直观感受SDK接入的效果。
根据需求和开发平台不同，会有以下常见的测试类型：
1、功能的测试
主要是场景覆盖和接口参数覆盖。主要测试各种参数下组合下的返回值。
考虑数据缓存和存储
考虑是否有回调
考虑对请求成功、或失败的处理结果与预期一致
2、兼容性的测试
根据产品需求是市场排行，确保兼容选取的设备机型、版本、分辨率等，并兼容其他软件
考虑模拟器的支持
覆盖多平台的，还要考虑多端消息数据包互通
3、性能方面的测试
满足特定的性能指标（CPU、内存、源码 竞拍耗电量、流量等）
特定场景性能：比如登录需要同步大量的数据包和离线消息，需要考虑对数据包的解析和本地储存的性能
4、稳定性方面的测试
业务场景在一定压力下，持续运行一段时间，接口功能和设备资源占有无异常。
5、弱网环境测试
对弱网，及其他不同类型网络和不同网络环境，SDK接口均应有较好的处理
对比依据是新老版本、竞品效果
6、安全性方面的测试
隐私数据的保护、访问权限控制、用户服务鉴权等
1、了解业务流程，确定开放给开发者都有哪些接口
2、了解SDK用到的所有协议，每个协议中字段的意义和作用以及server端处理逻辑
3、接口要校验输入参数各种输入情况是否能正确处理，返回值的正确性，是否有数据缓存到本地，检查是否有回调，如果有对于请求成功、请求失败（包括无网络、服务器返回非错误代码）是否都有调用
4、测试中对每个请求都应该抓包测试，查看请求的字段、参数值、返回值是否正确
5、对于协议中必传字段，SDK中是否校验为空的情况
6、查看是否存在多发、少发请求的情况
7、对于异步请求的结果在其他地方（A类中）会用到的情况，检查是否存在网络较慢情况下，未完成请求数据为空时A类就用到数据
一文详解RocketMQ-Spring的源码解析与实战
RocketMQ-Spring源码解析与实战概览
这篇文章详细阐述了在Spring Boot项目中如何运用rocketmq-spring SDK进行消息收发，以及开发者视角下SDK的设计逻辑。通过一步步操作流程，理解其在生产者和消费者端的实际应用。SDK简介
rocketmq-spring本质上是一个Spring Boot启动器，通过“约定优于配置”的理念简化集成过程。只需在pom.xml中引入依赖，并在配置文件中进行简单的配置，如添加名字服务地址和生产者组。配置与操作流程
1. 在pom.xml引入依赖并配置，如生产者和消费者配置。生产者配置：包含名字服务地址和生产者组
消费者配置：实现消息监听器
核心源码分析
rocketmq-spring的核心模块包括启动器、SDK模块和示例代码模块，源码中着重解析了RocketMQTemplate类和消费者启动机制，如生产者模板封装和消费者消息处理逻辑。生产者模板与消费者启动
生产者：通过RocketMQProperties对象绑定配置，创建生产者Bean并整合到RocketMQTemplate中
消费者：通过ListenerContainerConfiguration自动启动，封装RocketMQListener的消费逻辑
进阶学习
要深入学习rocketmq-spring，可以从实际操作、模块设计、starter设计思路和源码理解四个方面逐步提升。ijkPlayer SDK 源码导入到Android Studio中各种问题解决 第二篇
在将ijkPlayer SDK导入Android Studio并进行编译过程中，我遇到了多个问题。这些问题在前篇博客《ijkPlayer SDK 源码导入Android Studio中各种问题解决 第一篇》中已经部分探讨过，zinyan.com。问题与解决
问题一：Flavors错误
在代码无误的情况下，运行时出现Flavors错误。原因在于ijkplayer项目的build.gradle版本过低，需添加一个维度名称到flavorDimensions。只需定义任意维度名即可解决问题。问题二：exoplayer库缺失
找不到com.google.android.exoplayer:exoplayer:r1.5.，可能由于网络问题或仓库不稳定。在ijkplayer-exo模块的build.gradle中，将依赖库切换至国内镜像如阿里云，添加相应配置后重新build即可。问题三：UnsatisfiedLinkError
编译后的apk在运行视频时崩溃，原因是找不到本地的libijkffmpeg.so。检查发现项目中未包含so文件，需将本地依赖改为远程依赖或自行编译导入。问题四：NDK版本不匹配
依赖的NDK版本与要求版本不一致，只需在Android Studio的SDK管理面板中下载.0.版本的NDK并安装，下载速度受网络影响。 成功解决了这些问题后，ijkplayer-example项目可以运行，但so库仍需进一步处理。后续将有更多关于so库编译的内容，敬请关注。anfroid开发怎么查看某个类或方法的源代码
android开发语言是java，由于java面向对象的特性，我们在开发中会非常多的用到继承重写等语言特性，一些内置类或方法在使用时需要我们重写或继承才能实现自定义，此时需要我们通过查看源代码来了解该函数或类的写法和用法。下面我们学习如何查看源代码。首先要先下载并安装好sdk源码，才可以查看。打开sdk manager
找到你的sdk已安装的最新的API版本，点击小三角，打开该API的详情。图中打开的是android4.4.2的API
勾选Sources for Android SDK，并点击install 1 package。
接着出现这个页面，点击Accept License，点击install，然后开始安装，稍等片刻后，安装成功。
安装成功后，当你想查看某个类或方法的实现细节，只需要按住ctrl键，将鼠标指向该类或方法，鼠标由箭头变成手指后，点击即可进入该类的源代码。如下图是activity类的源码。
CreateCollection API执行流程_milvus源码解析
在分析milvus源码中的CreateCollection API执行流程时，我们需要详细拆解从客户端请求到数据最终存储在etcd的过程。在milvus版本v2.3.2中，CreateCollection API的执行流程大致分为以下几个关键步骤：
首先，客户端SDK接收用户创建集合（collection）的请求，并将此请求封装为createCollectionTask，随后将其放入ddQueue队列。
随后，此任务在proxy内依次执行PreExecute、Execute和PostExecute三个方法。PreExecute阶段进行参数校验等预处理工作，Execute阶段则是真正执行逻辑，而PostExecute阶段完成执行后的清理工作，通常不做任何操作并返回nil。
在Execute方法中，proxy调用rootCoord的CreateCollection接口，此接口进一步封装请求为rootcoord里的createCollectionTask。
接下来，rootCoord的CreateCollection接口执行CreateCollectionTask的Prepare、Execute和NotifyDone方法。核心操作在Execute阶段，其中涉及到多个步骤，包括expireCacheStep、addCollectionMetaStep、watchChannelsStep、changeCollectionStateStep等。在这些步骤中，重点是addCollectionMetaStep，负责etcd元数据的操作。
在addCollectionMetaStep的Execute方法中，s.core.meta.AddCollection方法被调用。此方法在etcd中创建了多个与集合相关的key-value对，这些key值按照特定规则构建，反映了集合、分区和字段之间的关系。
具体而言，集合信息通过key `root-coord/database/collection-info/1/` 存储在etcd中，value为protobuf序列化的etcdpb.CollectionInfo，这表示集合由ID、DbId、schema等组成，schema中不记录字段、分区ID或名称等信息。etcd以二进制形式存储这些数据。
分区信息通过类似 `root-coord/partitions//` 的路径存储，value为etcdpb.PartitionInfo，同样采用protobuf序列化后存储在etcd中。此信息包括partitionID、partitionName、collectionId等。
字段信息通过 `root-coord/fields//` 的路径存储，value为schemapb.FieldSchema，包含字段ID、名称、描述、数据类型等信息。
在执行完毕后，将所有key-value对批量写入etcd，最终完成集合的创建。
总结而言，CreateCollection API的执行流程涉及多个组件协作，从客户端请求开始，经过proxy和rootCoord的处理，最终在etcd中存储集合、分区和字段的元数据，实现了集合的创建。整个流程中，etcd作为关键的数据存储层，提供了持久化和高可用性保障。
2024-12-29 04:03
2024-12-29 03:13
2024-12-29 03:00
2024-12-29 02:40
2024-12-29 01:58
