使用Electron集成环信UIKit,实现发送消息

写在前面

环信单群聊 UIKit 是基于环信即时通讯云 IM SDK 开发的一款即时通讯 React UI 组件库,本篇文章介绍如何在Electron中集成环信UIKit,采用框架Electron-vite-react


准备工作

1.已注册环信即时通讯云并在console后台创建了AppKey。

2.了解并可以创建Electron-vite-react项目

3.了解环信UIkit各功能以及api调用,点此了解


开始集成

第一步:创建一个Electron项目(进度10%)

Electron-vite官网有详细的教程,此处不做过多赘述,仅以当前示例项目为参考集成,更多详情指路官网

yarn create @quick-start/electron electronReact --template react

第二步:安装依赖(进度15%)

yarn install

第三步:启动项目(进度20%)

yarn run dev

到这一步我们可以得到下图
603373b4a8aaa944741d44bb4dc5caa5.png

你的目录结构如下图
3792ed20a8df5b49a45edbf1180aae2f.png

第四步:安装UIKit (进度50%)

安装easemob-chat-uikit

使用 npm 安装 easemob-chat-uikit 包

npm install easemob-chat-uikit --save

使用 yarn 安装 easemob-chat-uikit 包

yarn add easemob-chat-uikit

第五步:引入UIKit组件(进度80%)

1、删除App.tsx自带的内容,在App.tsx中引入UIKit组件

import {
  Provider as UIKitProvider,
  Chat,
  ConversationList,
  useClient
} from 'easemob-chat-uikit'
import 'easemob-chat-uikit/style.css'
import { useEffect } from 'react'
import './App.css'
const ChatApp = () => {
  const client = useClient()
  useEffect(() => {
    client &&
      client
        .open({
          user: 'userId',
          pwd: 'pwd'
        })
        .then((res) => {
          console.log('get token success', res)
        })
  }, [client])
  return (
    <div className="app_container">
      <div className="conversation_container">
        <ConversationList />
      </div>
      <div className="chat_container">
        <Chat />
      </div>
    </div>
  )
}
function App(): JSX.Element {
  return (
    <UIKitProvider
      initConfig={{
        appKey: 'your app key'
      }}
    >
      <ChatApp />
    </UIKitProvider>
  )
}

export default App

2、将src/renderer/src/assets/main.css中的css样式全部替换如下

body {
  display: flex;
  flex-direction: column;
  font-family:
    Roboto,
    -apple-system,
    BlinkMacSystemFont,
    'Helvetica Neue',
    'Segoe UI',
    'Oxygen',
    'Ubuntu',
    'Cantarell',
    'Open Sans',
    sans-serif;
  color: #86a5b1;
  background-color: #2f3241;
}

* {
  padding: 0;
  margin: 0;
}

ul {
  list-style: none;
}

code {
  font-weight: 600;
  padding: 3px 5px;
  border-radius: 2px;
  background-color: #26282e;
  font-family:
    ui-monospace,
    SFMono-Regular,
    SF Mono,
    Menlo,
    Consolas,
    Liberation Mono,
    monospace;
  font-size: 85%;
}

a {
  color: #9feaf9;
  font-weight: 600;
  cursor: pointer;
  text-decoration: none;
  outline: none;
}

a:hover {
  border-bottom: 1px solid;
}

.container {
  flex: 1;
  display: flex;
  flex-direction: column;
  max-width: 840px;
  margin: 0 auto;
  padding: 15px 30px 0 30px;
}

.versions {
  margin: 0 auto;
  float: none;
  clear: both;
  overflow: hidden;
  font-family: 'Menlo', 'Lucida Console', monospace;
  color: #c2f5ff;
  line-height: 1;
  transition: all 0.3s;
}

.versions li {
  display: block;
  float: left;
  border-right: 1px solid rgba(194, 245, 255, 0.4);
  padding: 0 20px;
  font-size: 13px;
  opacity: 0.8;
}

.versions li:last-child {
  border: none;
}

.hero-logo {
  margin-top: -0.4rem;
  transition: all 0.3s;
}

@media (max-width: 840px) {
  .versions {
    display: none;
  }

  .hero-logo {
    margin-top: -1.5rem;
  }
}

.hero-text {
  font-weight: 400;
  color: #c2f5ff;
  text-align: center;
  margin-top: -0.5rem;
  margin-bottom: 10px;
}

@media (max-width: 660px) {
  .hero-logo {
    display: none;
  }

  .hero-text {
    margin-top: 20px;
  }
}

.hero-tagline {
  text-align: center;
  margin-bottom: 14px;
}

.links {
  display: flex;
  align-items: center;
  justify-content: center;
  margin-bottom: 24px;
  font-size: 18px;
  font-weight: 500;
}

.links a {
  font-weight: 500;
}

.links .link-item {
  padding: 0 4px;
}

.features {
  display: flex;
  flex-wrap: wrap;
  margin: -6px;
}

.features .feature-item {
  width: 33.33%;
  box-sizing: border-box;
  padding: 6px;
}

.features article {
  background-color: rgba(194, 245, 255, 0.1);
  border-radius: 8px;
  box-sizing: border-box;
  padding: 12px;
  height: 100%;
}

.features span {
  color: #d4e8ef;
  word-break: break-all;
}

.features .title {
  font-size: 17px;
  font-weight: 500;
  color: #c2f5ff;
  line-height: 22px;
  overflow: hidden;
  text-overflow: ellipsis;
  white-space: nowrap;
}

.features .detail {
  font-size: 14px;
  font-weight: 500;
  line-height: 22px;
  margin-top: 6px;
}

@media (max-width: 660px) {
  .features .feature-item {
    width: 50%;
  }
}

@media (max-width: 480px) {
  .links {
    flex-direction: column;
    line-height: 32px;
  }

  .links .link-dot {
    display: none;
  }

  .features .feature-item {
    width: 100%;
  }
}


3、在src/renderer/src目录下添加App.css
.app_container {
  width: calc(100%);
  height: 100vh;
  display: flex;
}
.conversation_container {
  width: 30%;
}
.chat_container {
  width: 70%;
}

到这一步你可以得到如下图
916d3afda6cd9221d4b7529b94b97b12.png

第六步:解决问题(进度99%)

在第五步执行完毕之后发现调试器有如下图报错
9cfb56a36da4733a03aab62131643a1f.png

经查阅资料,发现是Electron内容安全策略在搞鬼,并提供了解决方案
6a50d827b64c3b0a539fb89f37fec564.png

接下来我们就需要在src/renderer/index.html中更改meta标签
同样out/renderer/index.html也需要更改meta标签

<meta
      http-equiv="Content-Security-Policy"
      content="font-src 'self' data:; img-src 'self' data:; default-src 'self'; connect-src * ws://* wss://*; script-src 'self' 'unsafe-eval'; style-src 'self' 'unsafe-inline'"
    />

接下来保存代码并运行你将得到下图
035fbe295226807d62a4acbedd7c484c.png

第七步:发送消息(进度100%)

点击好友并发送一条消息,如下图
c24db9456278c8fe91ae054d55f513e4.png

恭喜你集成完毕啦~

总结:

通过以上步骤,你已经成功在Electron中集成了环信单聊 UIKit 并实现了基本的即时通讯功能,接下来继续根据 UIKit 提供的组件和 API 文档进行进一步开发吧~

相关文档:

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值