Android设备通过SMB向电脑传输数据完全攻略——BySMB项目实战手册

窦萍娴Prudent

于 2024-10-18 11:53:19 发布

阅读量887

点赞数 10

本文链接：https://blog.csdn.net/gitblog_01252/article/details/143044462

版权

Android设备通过SMB向电脑传输数据完全攻略——BySMB项目实战手册

BySMB Android 通过SMB (Server Message Block)，实现手机给电脑传输数据项目地址: https://gitcode.com/gh_mirrors/by/BySMB

一、项目基础介绍与编程语言

BySMB 是一个专为Android平台设计的开源项目，它利用Server Message Block（SMB）协议，实现了手机与电脑之间便捷的数据传输功能。这意味着用户可以轻松地将文件从Android手机发送到已设置好共享的电脑端。项目基于Kotlin和部分Java进行开发，确保了现代性和易用性。

二、关键技术和框架

核心库: BySMB的核心在于其自定义的SMB处理逻辑，虽然没有直接依赖于成熟的第三方SMB库，但通过简洁的API封装，实现了与SMB服务器（如Windows共享或Mac共享）的高效交互。
网络通信: 利用Android SDK中的网络连接能力来执行文件的上传下载操作，确保跨设备的数据交换。
权限管理: 项目需要处理Android系统的网络权限，以保证应用能够访问互联网，实现文件传输。

三、安装与配置步骤

准备工作

环境需求: 确保您的Android设备运行的是支持上述功能的操作系统版本，并且开发者已提供适用于当前Android API级别的应用版本。
电脑端设置:
- Mac: 需要进入“系统偏好设置” -> “共享”，开启“文件共享”，并指定共享文件夹及相应的用户名和密码。
- Windows: 访问文件夹属性，设置“共享”与“安全”选项，添加适当的访问用户和密码。
相同局域网连接: 确保手机和电脑连接在同一个Wi-Fi下，以便进行局域网内的文件传输。

安装步骤

获取源码: 访问GitHub仓库，点击“Code”按钮，选择克隆或下载ZIP包到本地。
导入项目: 使用Android Studio，选择“Open an existing Android Studio project”，找到刚才下载解压的BySMB项目文件夹，点击打开。
配置Maven仓库: 在项目的build.gradle（位于项目根目录，非app模块内）文件中加入JitPack.io的Maven仓库地址，确保能够正确解析BySMB的依赖。
```
allprojects {
    repositories {
        maven { url 'https://jitpack.io' }
    }
}
```
添加依赖: 进入'app'模块的build.gradle文件，添加BySMB的依赖项：
```
dependencies {
    implementation 'com.github.youlookwhat:BySMB:1.2.5'
}
```
确认版本号与仓库最新发布的版本相匹配。

应用配置与使用

权限申请: 在AndroidManifest.xml文件中添加互联网权限：
```
<uses-permission android:name="android.permission.INTERNET"/>
```
初始化BySMB: 在Application或主Activity启动时调用BySMB.initProperty()进行初始化。

文件传输操作:

获取SMB实例并配置目标电脑信息：

val bySmb = BySMB.with()
    .setConfig(ipAddress, username, password, sharedFolderName)
    .setReadTimeOut(60)
    .setSoTimeOut(180)
    .build()

示例操作，如上传文件：

fun upload(bySmb: BySMB) {
    val content = ... // 文件内容
    val fileName = ... // 文件名
    val fileToWrite = writeStringToFile(content, fileName)
    bySmb.writeFile(fileToWrite) { success ->
        if (success) {
            println("文件上传成功")
        } else {
            println("上传失败")
        }
    }
}