介绍

Fresns 是一款免费开源的社交网络服务软件，专为跨平台而打造的通用型社区产品，支持灵活多样的内容形态，可以满足多种运营场景，符合时代潮流，更开放且更易于二次开发。

• 点击了解产品 16 个功能特色
• 使用者请阅读安装教程和运营文档
• 扩展插件开发者请阅读扩展文档和数据字典
• 客户端开发者（网站端、小程序、App）请阅读 API 文档

产品亮点

• 免费开源，采用 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.js this.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 授权的开源软件。