SMB是什么

SMB，即"Server Message Block" 服务器信息块，是一个网络文件共享协议，它能被用于Web连接和客户端与服务器之间的信息沟通，允许应用程序和终端用户从远端的文件服务器访问文件资源。

SMB通信协议是微软（Microsoft）和英特尔(Intel)在1987年制定的协议，主要是作为Microsoft网络的通讯协议。SMB 是在会话层（session layer）和表示层（presentation layer）以及小部分应用层（application layer）的协议。

通过它可以简单的给电脑传输文件，不过SMB不太安全：
SMB协议中采用控制文件安全传输的机制是使用客户身份验证的方式，该方式通过客户端向服务器端发送验证密码来获取文件传输的权限，不过针对该机制的网络攻击相对严重，攻击程序通过对验证密码的截获来窃取文件的访问权限，局域网下文件传输的安全性得不到保障。

使用场景

一般不会采用这种方式来实现具体的功能需求，有一些特殊的场景会用到，例如：

一些手机上的壁纸软件，有横屏的壁纸，但是横屏的壁纸一般在电脑上使用，如果用SMB技术就可以直接将图片传到电脑的文件夹内，不用下载在本地后再通过微信/QQ传给电脑，方便很多。
再如我们有时候有一个很大的apk包，通过微信传给电脑会改后缀名，QQ可能还有大文件限制，这时候也可以考虑使用SMB来解决，毕竟自己写的传输代码，逼格直接拉满🤡。
再者想要直接将设备中操作的数据反应在电脑上查看，例如一个平板端的视力检测工具，检测后直接将数据反应在电脑上供工作人员使用。

如何使用

1.前提条件

手机和电脑连接到同一局域网
电脑需要设置用户名和密码
设置共享文件夹 (smb://username:password@ip/folder。（登录鉴权）)
- Mac设置：系统偏好设置-共享-文件共享-添加共享文件夹
- Windows设置：文件夹-共享-高级共享-权限-打开更改权限
电脑不能息屏

设置共享文件夹:

Mac设置	Windows设置
Mac设置	Windows设置

2.代码配置

具体源码见GitHub：BySMB

Demo使用

1).代码引入

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

dependencies {
    implementation 'com.github.youlookwhat:BySMB:1.1.0'
}

2).开启联网权限

<uses-permission android:name="android.permission.INTERNET" />

3).在Application初始化

BySMB.initProperty()

4).得到SMB实例

val bySmb = BySMB.with()
        .setConfig(
                et_ip.text.toString(),       // ip
                et_username.text.toString(),// 用户名
                et_password.text.toString(),// 密码
                et_foldName.text.toString()// 共享文件夹名
        )
        .setReadTimeOut(60)
        .setSoTimeOut(180)
        .build()

查看ip:

Mac上查看ip：ifconfig | grep "inet"
Windows上查看ip：ipconfig

3.上传文件到电脑

fun upload(bySmb: BySMB) {
    // 生成文件 File
    val writeStringToFile = writeStringToFile(
            instance,
            et_content.text.toString(), // 文本内容
            et_fileName.text.toString()// 文件名，例如:随感笔记.txt
    )
    // 上传
    bySmb.writeToFile(writeStringToFile, object : OnOperationFileCallback {

        override fun onSuccess() {
            // 成功
        }

        override fun onFailure(message: String) {
            // 失败
        }

    })
}

注意：如上传相同文件名的文件，会覆盖之前文件的内容。

4.查找电脑上的文件列表

fun listFile(bySmb: BySMB){
    // 读取根目录下的所有文件，重载方法("", "*.txt", callback)
    bySmb.listShareFileName(object : OnReadFileListNameCallback {
        override fun onSuccess(fileNameList: List<String>) {
            // 读取成功 fileNameList文件名列表
        }

        override fun onFailure(message: String) {
             // 失败
        }
    })
}

5.删除电脑上的文件

fun deleteFile(bySmb: BySMB){
    bySmb.deleteFile(et_fileName.text.toString(), object : OnOperationFileCallback {
        override fun onSuccess() {
        // 删除成功
        }

        override fun onFailure(message: String) {
            // 失败
        }
    })
}