WeIdentity JAVA SDK 安装部署工具（不部署智能合约）¶

整体介绍¶

一条区块链里，有多家机构，只需要一家机构部署 WeIdentity 智能合约，部署完成后，将智能合约地址给到其他机构即可。

不部署 WeIdentity 智能合约的机构，参考本文档完成安装部署和集成。
部署 WeIdentity 智能合约的机构，可以参考WeIdentity Java SDK 安装部署工具（部署智能合约。

部署步骤¶

1. 部署 WeIdentity 智能合约¶

1.1 下载安装部署工具¶

git clone https://github.com/WeBankBlockchain/weid-build-tools.git

1.2 配置基本信息¶

weid-java-sdk 可以同时支持 FISCO BCOS 1.3版本和 FISCO BCOS 2.0 版本。

1.2.1 基本配置¶

cd weid-build-tools
vim run.config

配置区块链节点信息，填入区块链节点 IP 和 Channel端口，示例如下：

注解

区块链节点Channel端口说明见FISCO BCOS 2.0配置文件说明或 FISCO BCOS 1.3 配置文件说明。

blockchain_address=10.10.10.10:20200

如果需要配置多个区块链节点，用逗号分隔，示例如下：

blockchain_address=10.10.10.10:20200,10.10.10.11:20200

配置 FISCO BCOS 版本信息，如果您使用 FISCO BCOS 2.0 版本则配置为2，FISCO BCOS 1.3 则配置为 1：

blockchain_fiscobcos_version=2

配置机构名称，该名称也被用作后续机构间的 AMOP 通信标识。

假设您的机构名为 test，您可以配置为：

org_id=test

配置 chain-id，该配置项用于路由到不同的网络，假设您的 chain-id 定义为1，则您可以配置为：

chain_id=1

保存退出，即完成基本配置。

1.2.2 配置节点证书和秘钥文件¶

cd resources/

FISCO BCOS 2.0请参考2.0 web3sdk客户端配置将证书文件 ca.crt， node.crt 和 node.key 复制出来，拷贝至当前目录下。

FISCO BCOS 1.3请参考1.3 web3sdk客户端配置将证书文件 ca.crt 和 client.keystore 复制出来，拷贝至当前目录下。

1.3 部署智能合约并自动生成配置文件¶

如果您是第一次使用本工具，您需要先进行编译：

注解

如果您重新修改了 run.config 里的配置项，您也需要重新编译。

cd ..
chmod +x compile.sh
./compile.sh

如果执行过程没报错，大约半分钟左右可以编译完成。

1.4 配置您的配置文件

您需要向发布 WeIdentity 智能合约的机构索要智能合约地址，并将对应的智能合约地址填入对应的项。

cd resources/
vim fisco.properties

您需要将每个配置项替换成对应的智能合约地址，比如，如果 WeID Contract 的发布地址是0xabbc75543648af0861b14daa4f8582f28cd95f5e，您需要将 weId.contractaddress 对应的值替换成 0xabbc75543648af0861b14daa4f8582f28cd95f5e，变成以下内容：

weid.contractaddress=0xabbc75543648af0861b14daa4f8582f28cd95f5e

其他的 cpt.contractaddress， issuer.contractaddress， evidence.contractaddress 和 specificissuer.contractaddress 都进行对应的智能合约地址替换，完成后保存退出即可。

至此，您已经完成 weid-java-sdk 的安装部署，您可以开始您的 Java 应用集成以及便捷工具体验。

注解

一条联盟链里，当一家机构部署 WeIdentity 智能合约成功后，需要将上述智能合约地址发给其他机构。

2 weid-java-sdk 的集成¶

2.1 在自己的Java应用中引入 weid-java-sdk¶

在自己的 Java 应用通过 build.gradle 引入，目前 weid-java-sdk 暂时只支持 gradle 方式引入。

compile("com.webank:weid-java-sdk:1.3.2")

2.2 配置您的Java应用¶

将 weid-build-tools 里配置好的配置文件拷贝至您的Java应用中：

cd resources/
ls

您可以将 resources 目录下的所有文件拷贝至您的 Java 应用的 resources 目录下，weid-java-sdk 会自动加载相应的资源文件。

现在您可以使用 WeIdentity 开发您的区块链身份应用。weid-java-sdk 相关接口请见：WeIdentity JAVA SDK文档。

我们提供了一个基于WeID的开发样例，您可以参考。

3. WeIdentity JAVA SDK 便捷工具使用¶

我们提供了一些快捷工具，可以帮您快速体验 weid-java-sdk，请参考WeIdentity JAVA SDK 便捷工具使用。