# 環境搭建
## 環境搭建 編譯
### node 安裝
Node.js安裝包及源碼下載地址為:[https://nodejs.org/en/download/](https://nodejs.org/en/download/)。
安裝完成后,打開命令行,輸入:node -v,如果結果為版本號,表明安裝成功
```
$ node -v
v6.10.3
```
### cnpm 設置
國內使用npm時有時速度很慢,推薦使用cnpm替代,使用方法和npm一樣,鏈接:[淘寶 NPM 鏡像](https://npm.taobao.org/)
```
$ npm install -g cnpm --registry=https://registry.npm.taobao.org
$ cnpm -v
cnpm@5.1.1 (/usr/local/lib/node_modules/cnpm/lib/parse_argv.js)
npm@5.3.0 (/usr/local/lib/node_modules/cnpm/node_modules/npm/lib/npm.js)
node@6.10.3 (/usr/local/bin/node)
npminstall@3.1.1 (/usr/local/lib/node_modules/cnpm/node_modules/npminstall/lib/index.js)
prefix=/usr/local
darwin x64 17.2.0
registry=http://registry.npm.taobao.org
```
### Cesium代碼
1. 下載官方包 [地址](https://cesiumjs.org/downloads/),由于總所周知的原因,速度很感人
1. [百度云鏈接]( https://pan.baidu.com/s/1c17pgRI) 密碼: 9g73 版本1.40
1. 如果想了解最新的進展可以直接克隆 github 上的代碼 [github地址](https://github.com/AnalyticalGraphicsInc/cesium),
注意有些特性在分支版本里面才有,
### 獲取安裝包之后
1. 解壓
2. 打開命令行,進入當前目錄
3. 安裝依賴,輸入:cnpm install,等待安裝完成,然后輸入: node server.js
```
$ cd ./Cesium-1.40
$ cnpm install
...
Installed 37 packages
Linked 569 latest versions
$ node server.js
Cesium development server running locally. Connect to http://localhost:8080/
```
打開瀏覽器,輸入 [http://localhost:8080/](http://localhost:8080/) (瀏覽器必須支持webgl,推薦使用chrome)
如果出現

4. 到這里,環境搭建完成。
## 推薦使用編輯器
如果單純的學習如何使用的話,使用[http://localhost:8080/Apps/Sandcastle/index.html](http://localhost:8080/Apps/Sandcastle/index.html)應該就夠了,如果要使用編輯器的話,推薦使用[vscode](https://code.visualstudio.com/).
# 使用說明
環境搭建好之后,輸入 http://localhost:8080/ 有兩個鏈接非常重要
[Documentation](http://localhost:8080/Build/Documentation/index.html)
[Sandcastle](http://localhost:8080/Apps/Sandcastle/index.html)
## Documentation
里面是Cesium的完整的API說明,里面可以找到:
+ 某一個模塊的所有函數,屬性
+ 部分效果截圖
+ 部分函數,屬性調用代碼示例
缺點:搜索功能不夠強大
## Sandcastle
這個就厲害了,是一個沙盒,你可以在里面
+ 瀏覽當前版本的一些功能特性
+ 一個可運行的代碼庫
+ 新建一個頁面,進行代碼測試
+ 導出測試代碼
+ ...
## 推薦的學習方式
1. 先瀏覽一遍沙盒里的所有示例,Cesium能做什么,做成什么樣,心里有數
1. 做自己需要的功能時,查找到相關示例代碼,弄懂,最好瀏覽一遍用到的模塊的API
1. 如果是深入研究的話,就需要有對WebGL有更深層次的了解
1. 用它做自己感興趣的項目。。。
**Cesium學習交流群:593764057(滿),476893082**
- cesium編程入門(一)cesium簡介
- cesium編程入門(二)環境搭建
- cesium編程入門(三)開始使用cesium開發
- cesium編程入門(四)界面介紹及小控件隱藏
- cesium編程入門(五)繪制形狀
- cesium編程入門(六)添加 3D Tiles,并調整位置,貼地
- cesium編程入門(七)3D Tiles,模型旋轉
- cesium編程入門(八)設置材質
- cesium編程入門(九)實體 Entity
- cesium編程入門(十)優秀資源
- cesium編程入門(十一)常見問題
- cesium編程中級開篇
- cesium編程中級(一)添加示例到Sandcastle
- cesium編程中級(二)源碼編譯
- cesium編程中級(三)嘗試添加PBS本地服務
- cesium編程中級(四)使用漸變紋理