• 设为首页
  • 点击收藏
  • 手机版
    手机扫一扫访问
    迪恩网络手机版
  • 关注官方公众号
    微信扫一扫关注
    公众号

Rapsssito/react-native-tcp-socket: React Native TCP socket API for Android, iOS ...

原作者: [db:作者] 来自: 网络 收藏 邀请

开源软件名称(OpenSource Name):

Rapsssito/react-native-tcp-socket

开源软件地址(OpenSource Url):

https://github.com/Rapsssito/react-native-tcp-socket

开源编程语言(OpenSource Language):

Java 36.7%

开源软件介绍(OpenSource Introduction):

react-native-tcp-socket

React Native TCP socket API for Android, iOS & macOS with client SSL/TLS support. It allows you to create TCP client and server sockets, imitating Node's net API functionalities (check the available API for more information).

Table of Contents

Getting started

Install the library using either Yarn:

yarn add react-native-tcp-socket

or npm:

npm install --save react-native-tcp-socket

Overriding net

Since react-native-tcp-socket offers the same API as Node's net, in case you want to import this module as net or use require('net') in your JavaScript, you must add the following lines to your package.json file.

{
  "react-native": {
    "net": "react-native-tcp-socket"
  }
}

In addition, in order to obtain the TS types (or autocompletion) provided by this module, you must also add the following to your custom declarations file.

...
declare module 'net' {
    import TcpSockets from 'react-native-tcp-socket';
    export = TcpSockets;
}

If you want to avoid duplicated net types, make sure not to use the default node_modules/@types in your tsconfig.json "typeRoots" property.

Check the example app provided for a working example.

Using React Native >= 0.60

Linking the package manually is not required anymore with Autolinking.

  • iOS Platform:

    $ cd ios && pod install && cd .. # CocoaPods on iOS needs this extra step

  • Android Platform:

    Modify your android/build.gradle configuration to match minSdkVersion = 21:

    buildscript {
      ext {
        ...
        minSdkVersion = 21
        ...
      }
    

Self-Signed SSL (only available for React Native > 0.60)

You will need a metro.config.js file in order to use a self-signed SSL certificate. You should already have this file in your root project directory, but if you don't, create it. Inside a module.exports object, create a key called resolver with another object called assetExts. The value of assetExts should be an array of the resource file extensions you want to support.

If you want to support .pem files (plus all the already supported files), your metro.config.js would like like this:

const {getDefaultConfig} = require('metro-config');
const defaultConfig = getDefaultConfig.getDefaultValues(__dirname);

module.exports = {
  resolver: {
    assetExts: [...defaultConfig.resolver.assetExts, 'pem'],
  },
  // ...
};

Using React Native < 0.60

You then need to link the native parts of the library for the platforms you are using. The easiest way to link the library is using the CLI tool by running this command from the root of your project:

$ react-native link react-native-tcp-socket

If you can't or don't want to use the CLI tool, you can also manually link the library using the instructions below (click on the arrow to show them):

Manually link the library on iOS
  1. In XCode, in the project navigator, right click LibrariesAdd Files to [your project's name]
  2. Go to node_modulesreact-native-tcp-socket and add TcpSockets.xcodeproj
  3. In XCode, in the project navigator, select your project. Add libTcpSockets.a to your project's Build PhasesLink Binary With Libraries
  4. Run your project (Cmd+R)<
Manually link the library on Android
  1. Open up android/app/src/main/java/[...]/MainApplication.java
  • Add import com.asterinet.react.tcpsocket.TcpSocketPackage; to the imports at the top of the file
  • Add new TcpSocketPackage() to the list returned by the getPackages() method
  1. Append the following lines to android/settings.gradle:
    include ':react-native-tcp-socket'
    project(':react-native-tcp-socket').projectDir = new File(rootProject.projectDir, 	'../node_modules/react-native-tcp-socket/android')
    
  2. Insert the following lines inside the dependencies block in android/app/build.gradle:
      implementation project(':react-native-tcp-socket')
    

React Native Compatibility

To use this library you need to ensure you are using the correct version of React Native. If you are using a version of React Native that is lower than 0.60 you will need to upgrade before attempting to use this library latest version.

react-native-tcp-socket version Required React Native Version
5.X.X, 4.X.X, 3.X.X >= 0.60.0
1.4.0 >= Unknown

Usage

Import the library:

import TcpSocket from 'react-native-tcp-socket';
// const net = require('react-native-tcp-socket');

Client

// Create socket
const client = TcpSocket.createConnection(options, () => {
  // Write on the socket
  client.write('Hello server!');

  // Close socket
  client.destroy();
});

client.on('data', function(data) {
  console.log('message was received', data);
});

client.on('error', function(error) {
  console.log(error);
});

client.on('close', function(){
  console.log('Connection closed!');
});

Server

const server = TcpSocket.createServer(function(socket) {
  socket.on('data', (data) => {
    socket.write('Echo server ' + data);
  });

  socket.on('error', (error) => {
    console.log('An error ocurred with client socket ', error);
  });

  socket.on('close', (error) => {
    console.log('Closed connection with ', socket.address());
  });
}).listen({ port: 12345, host: '0.0.0.0' });

server.on('error', (error) => {
  console.log('An error ocurred with the server', error);
});

server.on('close', () => {
  console.log('Server closed connection');
});

SSL Client

const client = TcpSocket.createConnection({
    port: 8443,
    host: "example.com",
    tls: true,
    // tlsCheckValidity: false, // Disable validity checking
    // tlsCert: require('./selfmade.pem') // Self-signed certificate
});

// ...

Note: In order to use self-signed certificates make sure to update your metro.config.js configuration.

API

Here are listed all methods implemented in react-native-tcp-socket, their functionalities are equivalent to those provided by Node's net (more info on #41). However, the methods whose interface differs from Node are marked in bold.

Socket

createConnection()

createConnection(options[, callback]) creates a TCP connection using the given options.

createConnection: options

Required. Available options for creating a socket. It must be an object with the following properties:

Property Type iOS/macOS Android Description
port <number> Required. Port the socket should connect to.
host <string> Host the socket should connect to. IP address in IPv4 format or 'localhost'. Default: 'localhost'.
timeout <number> If set, will be used to call setTimeout(timeout) after the socket is created, but before it starts the connection.
localAddress <string> Local address the socket should connect from. If not specified, the OS will decide. It is highly recommended to specify a localAddress to prevent overload errors and improve performance.
localPort <number> Local port the socket should connect from. If not specified, the OS will decide.
interface <string> Interface the socket should connect from. If not specified, it will use the current active connection. The options are: 'wifi', 'ethernet', 'cellular'.
reuseAddress <boolean> Enable/disable the reuseAddress socket option. Default: true.
tls <boolean> Enable/disable SSL/TLS socket creation. Default: false.
tlsCheckValidity <boolean> Enable/disable SSL/TLS certificate validity check. Default: true.
tlsCert <any> CA file (.pem format) to trust. If null, it will use the device's default SSL trusted list. Useful for self-signed certificates. See example for more info. Default: null.

Note: The platforms marked as use the default value.

Server

listen()

listen(options[, callback]) creates a TCP server socket using the given options.

listen: options

Required. Available options for creating a server socket. It must be an object with the following properties:

Property Type iOS/macOS Android Description
port <number> Required. Port the socket should listen to.
host <string> Host the socket should listen to. IP address in IPv4 format or 'localhost'. Default: '0.0.0.0'.
reuseAddress <boolean> Enable/disable the reuseAddress socket option. Default: true.

Note: The platforms marked as use the default value.

Maintainers

Acknowledgments

License

The library is released under the MIT license. For more information see LICENSE.




鲜花

握手

雷人

路过

鸡蛋
该文章已有0人参与评论

请发表评论

全部评论

专题导读
热门推荐
阅读排行榜

扫描微信二维码

查看手机版网站

随时了解更新最新资讯

139-2527-9053

在线客服(服务时间 9:00~18:00)

在线QQ客服
地址:深圳市南山区西丽大学城创智工业园
电邮:jeky_zhao#qq.com
移动电话:139-2527-9053

Powered by 互联科技 X3.4© 2001-2213 极客世界.|Sitemap