Skip to content

Commit 49da944

Browse files
authored
lint & serval fix for .md (#81)
Co-authored-by: Dengke Tang <[email protected]>
1 parent c9712d5 commit 49da944

File tree

2 files changed

+39
-38
lines changed

2 files changed

+39
-38
lines changed

README.md

Lines changed: 29 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,5 @@
11
# AWS IoT SDK for Java v2
2+
23
This document provides information about the AWS IoT device SDK for Java V2.
34

45
If you have any issues or feature requests, please file an issue or pull request.
@@ -14,38 +15,40 @@ This SDK is built on the AWS Common Runtime, a collection of libraries
1415
cross-platform, high-performance, secure, and reliable. The libraries are bound
1516
to Java by the [aws-crt-java](https://github.com/awslabs/aws-crt-java) package.
1617

17-
1818
*__Jump To:__*
19+
1920
* [Installation](#Installation)
2021
* [Mac-Only TLS Behavior](#Mac-Only-TLS-Behavior)
2122
* [Samples](samples)
2223
* [Getting Help](#Getting-Help)
2324
* [Giving Feedback and Contributions](#Giving-Feedback-and-Contributions)
2425
* [More Resources](#More-Resources)
2526

26-
27-
2827
## Installation
2928

3029
### Minimum Requirements
31-
* Java 8 or above
3230

33-
** Set JAVA_HOME first
31+
* Java 8 or above
32+
33+
* Set JAVA_HOME first
3434

3535
### Requirements to build the AWS CRT locally
36-
* CMake 3.1+
37-
* Clang 3.9+ or GCC 4.4+ or MSVC 2015+
36+
37+
* CMake 3.1+
38+
* Clang 3.9+ or GCC 4.4+ or MSVC 2015+
3839

3940
### Build IoT Device SDK from source
40-
```
41+
42+
``` sh
4143
git clone https://github.com/awslabs/aws-iot-device-sdk-java-v2.git
4244
# update the version of the CRT being used
4345
mvn versions:use-latest-versions -Dincludes="software.amazon.awssdk.crt*"
4446
mvn clean install
4547
```
4648

4749
### Build CRT from source
48-
```sh
50+
51+
``` sh
4952
# NOTE: use the latest version of the CRT here
5053

5154
git clone --branch v0.4.20 https://github.com/awslabs/aws-crt-java.git
@@ -58,9 +61,11 @@ mvn clean install
5861
```
5962

6063
#### Android
64+
6165
Supports API 26 or newer.
6266
NOTE: The shadow sample does not currently complete on android due to its dependence on stdin keyboard input.
63-
```sh
67+
68+
``` sh
6469
git clone --recursive --branch v0.6.2 https://github.com/awslabs/aws-crt-java.git
6570
git clone https://github.com/awslabs/aws-iot-device-sdk-java-v2.git
6671
cd aws-crt-java/android
@@ -72,7 +77,8 @@ cd ../aws-iot-device-sdk-java-v2/android
7277
```
7378

7479
Add the following to your project's build.gradle:
75-
```groovy
80+
81+
``` groovy
7682
repositories {
7783
mavenCentral()
7884
maven {
@@ -85,55 +91,48 @@ dependencies {
8591
}
8692
```
8793

88-
89-
9094
## Mac-Only TLS Behavior
9195

92-
Please note that on Mac, once a private key is used with a certificate, that certificate-key pair is imported into the Mac Keychain. All subsequent uses of that certificate will use the stored private key and ignore anything passed in programmatically. Beginning in v1.2.6, when a stored private key from the Keychain is used, the following will be logged at the "info" log level:
96+
Please note that on Mac, once a private key is used with a certificate, that certificate-key pair is imported into the Mac Keychain. All subsequent uses of that certificate will use the stored private key and ignore anything passed in programmatically. When a stored private key from the Keychain is used, the following will be logged at the "info" log level:
9397

9498
```
9599
static: certificate has an existing certificate-key pair that was previously imported into the Keychain. Using key from Keychain instead of the one provided.
96100
```
97101

98-
99-
100102
## Samples
101103

102104
[Samples README](samples)
103105

104-
105106
## Getting Help
106107

107108
Use the following sources for information :
108-
* Check api and developer guides.
109-
* Check for similar issues already opened.
110-
111-
If you still can’t find a solution to your problem open an [issue](https://github.com/aws/aws-iot-device-sdk-java-v2/issues)
112109

110+
* Check api and developer guides.
111+
* Check for similar issues already opened.
113112

113+
If you still can’t find a solution to your problem open an [issue](https://github.com/aws/aws-iot-device-sdk-java-v2/issues)
114114

115115
## Giving Feedback and Contributions
116116

117117
We need your help in making this SDK great. Please participate in the community and contribute to this effort by submitting issues, participating in discussion forums and submitting pull requests through the following channels.
118-
* [Contributions Guidelines](master/CONTRIBUTING.md)
119-
* Articulate your feature request or upvote existing ones on our [Issues](https://github.com/aws/aws-iot-device-sdk-java-v2/issues?q=is%3Aissue+is%3Aopen+label%3Afeature-request) page.
120-
* Submit [Issues](https://github.com/aws/aws-iot-device-sdk-java-v2/issues)
121118

119+
* [Contributions Guidelines](master/CONTRIBUTING.md)
120+
* Articulate your feature request or upvote existing ones on our [Issues](https://github.com/aws/aws-iot-device-sdk-java-v2/issues?q=is%3Aissue+is%3Aopen+label%3Afeature-request) page.
121+
* Submit [Issues](https://github.com/aws/aws-iot-device-sdk-java-v2/issues)
122122

123123
## More Resources
124124

125-
* [AWS IoT Core Documentation](https://docs.aws.amazon.com/iot/)
126-
* [Developer Guide](https://docs.aws.amazon.com/iot/latest/developerguide/what-is-aws-iot.html) ([source](https://github.com/awsdocs/aws-iot-docs))
127-
* [Issues](https://github.com/aws/aws-iot-device-sdk-java-v2/issues)
128-
* [Dev Blog](https://aws.amazon.com/blogs/?awsf.blog-master-iot=category-internet-of-things%23amazon-freertos%7Ccategory-internet-of-things%23aws-greengrass%7Ccategory-internet-of-things%23aws-iot-analytics%7Ccategory-internet-of-things%23aws-iot-button%7Ccategory-internet-of-things%23aws-iot-device-defender%7Ccategory-internet-of-things%23aws-iot-device-management%7Ccategory-internet-of-things%23aws-iot-platform)
125+
* [AWS IoT Core Documentation](https://docs.aws.amazon.com/iot/)
126+
* [Developer Guide](https://docs.aws.amazon.com/iot/latest/developerguide/what-is-aws-iot.html) ([source](https://github.com/awsdocs/aws-iot-docs))
127+
* [Issues](https://github.com/aws/aws-iot-device-sdk-java-v2/issues)
128+
* [Dev Blog](https://aws.amazon.com/blogs/?awsf.blog-master-iot=category-internet-of-things%23amazon-freertos%7Ccategory-internet-of-things%23aws-greengrass%7Ccategory-internet-of-things%23aws-iot-analytics%7Ccategory-internet-of-things%23aws-iot-button%7Ccategory-internet-of-things%23aws-iot-device-defender%7Ccategory-internet-of-things%23aws-iot-device-management%7Ccategory-internet-of-things%23aws-iot-platform)
129129

130130
Integration with AWS IoT Services such as
131131
[Device Shadow](https://docs.aws.amazon.com/iot/latest/developerguide/iot-device-shadows.html)
132132
[Jobs](https://docs.aws.amazon.com/iot/latest/developerguide/iot-jobs.html)
133133
[Fleet Provisioning](https://docs.aws.amazon.com/iot/latest/developerguide/provision-wo-cert.html)
134134
is provided by code that been generated from a model of the service.
135135

136-
137-
# License
136+
## License
138137

139138
This library is licensed under the Apache 2.0 License.

samples/README.md

Lines changed: 10 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
#Samples
1+
# Samples
22

33
## Shadow
44

@@ -23,7 +23,8 @@ value.
2323
Source: `samples/Shadow`
2424

2525
To Run:
26-
```
26+
27+
``` sh
2728
> mvn exec:java -pl samples/Shadow -Dexec.mainClass=shadow.ShadowSample -Dexec.args='--endpoint <endpoint> --rootca /path/to/AmazonRootCA1.pem --cert <cert path> --key <key path> --thingName <thing name>'
2829
```
2930

@@ -98,7 +99,8 @@ On startup, the sample describes a job that is pending execution.
9899
Source: `samples/Jobs`
99100

100101
To Run:
101-
```
102+
103+
``` sh
102104
> mvn exec:java -pl samples/Jobs -Dexec.mainClass=jobs.JobsSample -Dexec.args='--endpoint <endpoint> --rootca /path/to/AmazonRootCA1.pem --cert <cert path> --key <key path> --thingName <thing name>'
103105
```
104106

@@ -173,15 +175,15 @@ Source: `samples/Identity`
173175
cd ~/samples/Identity
174176

175177
Run the sample using CreateKeysAndCertificate:
176-
177-
```
178+
179+
``` sh
178180
mvn exec:java -Dexec.mainClass="identity.FleetProvisioningSample" -Dexec.args="--endpoint <endpoint> --rootca <root ca path>
179181
--cert <cert path> --key <private key path> --templateName <templatename> --templateParameters <templateParams>"
180182
```
181183

182184
Run the sample using CreateCertificateFromCsr:
183-
184-
```
185+
186+
``` sh
185187
mvn exec:java -Dexec.mainClass="identity.FleetProvisioningSample" -Dexec.args="--endpoint <endpoint> --rootca <root ca path>
186188
--cert <cert path> --key <private key path> --templateName <templatename> --templateParameters <templateParams> --csr <csr path>"
187189
```
@@ -231,4 +233,4 @@ and receive.
231233
]
232234
}
233235
</pre>
234-
</details>
236+
</details>

0 commit comments

Comments
 (0)