介绍
Fresns 是一款免费开源的社交网络服务软件，专为跨平台而打造的通用型社区产品，支持灵活多样的内容形态，可以满足多种运营场景，符合时代潮流，更开放且更易于二次开发。
产品亮点
- 免费开源，采用 Apache-2.0 开源协议。
- 采用 Skyline 渲染引擎和 glass-easel 组件框架
- 界面文字支持多语言，时间值支持多时区，针对海外用户也能满足需求。
- 支持 Donut 跨端方案，编译成 iOS 和 Android 应用也方便。
- 可应用为社交媒体领域，同样也可以当成 Blog 或 CMS 等其他用途。
技术框架
本小程序是基于 Fresns API 开发，采用小程序原生语言，纯净干爽，无耦合。二开时使用任何第三方服务或样式库时不用担心兼容和冲突问题，因为我没有在代码里使用和绑定任何其他元素，二开更方便。
| 框架 | 版本 | 用途 |
|---|---|---|
| Fresns | 3.x | 后端 API |
| WeUI | 2.x | 小程序 UI 框架 |
使用说明
遵循 Fresns 客户端设计理念，小程序以结构化方式实现了全部功能，使用者可以根据自己的需求，自定义页面风格、交互体验、栏目命名、入口路径等，实现各自个性化的运营场景。
- 1、下载代码包；
- 2、解压后使用微信开发者工具导入项目，项目名称和 AppID 填写你的小程序信息；
- 3、从
/sdk/文件夹复制env.example.js文件到根目录，并重命名为env.js，然后根据里面的描述填写你的配置信息（公共密钥）； - 4、将你的
apiHost录入到微信配置：公众平台->开发->开发管理->开发设置- 服务器域名
request合法域名和uploadFile合法域名 - 业务域名
- 服务器域名
- 5、配置基础库最低可用版本
- 公众平台->设置->基本设置->版本设置->基础库最低可用版本
- 最低可用版本
3.1.0
- 6、申请位置信息接口
- 如果你不需要该功能，忽略下方开通描述，并删除
app.json配置文件中"requiredPrivateInfos": ["chooseLocation"] - 公众平台->开发->开发管理->接口设置
- 申请开通
wx.chooseLocation打开地图选择位置 - 申请时，可使用编辑器页面截图作为使用场景
- 如果你不需要该功能，忽略下方开通描述，并删除
- 7、自定义开发
- 修改风格样式，或者使用第三方开发的风格样式覆盖原文件
- 导航栏位置
components/commons/tabbar/ - 回调处理
mixins/fresnsCallback.js - 私有模式处理
mixins/common.jsthis.checkFresnsSiteMode();
- 8、使用微信开发者工具上传代码，提交到微信公众平台。
小程序支持编译成 iOS 和 Android 移动应用，也可以编译成 Web 网页应用，具体方法阅读 Donut 教程。
备注说明
- 本小程序是为开发者准备的，所以 TabBar 平铺了所有功能，开发者定制 UI 时自行新增或删减。
- 为了纯净干爽，UI 只使用了微信原生样式组件，二开时，可以替换使用其他样式库，比如使用 TDesign 等。
- 本小程序的开发指南 https://docs.fresns.com/zh-hans/clients/sdk/wechat/
- 基于本小程序定制开发的案例: https://github.com/jevantang/zhijie-app
小程序隐私保护指引
- 选中的照片或视频信息：用于
发表附带图片或视频的内容 - 选中的文件：用于
发表附带文件的内容 - 选择的位置信息：用于
发表附带位置信息的内容（未启用 chooseLocation 功能则无需选择该隐私功能） - 发布内容：用于
发表帖子和评论 - 剪切板：用于
复制分享链接和帖子内容中的超链接 - 设备信息：用于
记录互动和错误问题的日志
加入我们
Fresns 的开源社区正在急速增长中，如果你认可我们的开源软件，有兴趣为 Fresns 的发展做贡献，竭诚欢迎加入我们一起开发完善。无论是报告错误或是 Pull Request 开发，那怕是修改一个错别字也是对我们莫大的帮助。
贡献指南：https://fresns.org/contributing/
许可协议
Fresns 是根据 Apache-2.0 授权的开源软件。