# 环境搭建
## 环境搭建 编译
### 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),
注意有些特性在分支版本里面才有,![](https://box.kancloud.cn/e5b2d8aa87fa96af8c9104abd288afe9_930x1334.jpg)
### 获取安装包之后
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)
如果出现
![](https://box.kancloud.cn/44a47cbc7a8804a081fb78cfa616c148_3278x2054.jpg)
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编程中级(四)使用渐变纹理